設定

設定はプロセス全体に適用されます。

設定項目

jfinance.config

yfinance と共通の設定オブジェクトです。

設定	型	既定値	説明
`config.locale.lang`	`str`	`"en-US"`	`"ja-JP"` にすると会社名と業種名を日本語で返す
`config.locale.region`	`str`	`"US"`	地域
`config.network.proxy`	`str`	`None`	HTTP プロキシ
`config.network.retries`	`int`	`0`	失敗したリクエストの再試行回数
`config.debug.logging`	`bool`	`False`	リクエストと応答を記録する
`config.debug.hide_exceptions`	`bool`	`True`	属性の参照中に発生した例外を抑制する

jf.config.locale.lang = "ja-JP"
jf.Ticker("7203.T").info["shortName"]     # 'トヨタ自動車株式会社'

英語の原文がない値（事業の内容、役員・株主の氏名）は、言語設定にかかわらず日本語で返します。

jfinance.set_base_url(url) -> None
jfinance.get_base_url() -> str

接続先のサーバーを変更します。既定値は jfinance.DEFAULT_BASE_URL（https://query1.jfnc.org）です。

引数

名前	型	説明
`url`	`str`	接続先（`"http://localhost:8080"` など）

jf.set_base_url("http://localhost:8080")

jfinance.enable_debug_mode() -> None

リクエストと応答をすべて記録します。config.debug.logging を True に設定するのと同じです。

yfinance 向けに書かれたコードがそのまま動くよう、例外の名前は YF の接頭辞を含め yfinance のままとしています。

例外	基底クラス	送出される場面
`YFException`	`Exception`	以下の例外に共通する基底クラス
`YFRateLimitError`	`YFException`	レート制限（HTTP 429）。`Retry-After` ヘッダーの秒数だけ待って再試行する
`YFDataException`	`YFException`	応答が想定した形式と異なる
`YFTickerMissingError`	`YFException`	指定した銘柄が存在しない
`YFNotImplementedError`	`NotImplementedError`	互換性を保つために設けたが、EDINET に対応するデータがない

from jfinance.exceptions import YFRateLimitError

try:
    t.info
except YFRateLimitError:
    ...

その他の HTTP エラーでは requests.HTTPError がそのまま伝播します。レート制限については利用条件を参照してください。

jfinance.NOTICE_CORRECTIONS

EDINET の閲覧期間が満了した書類に対する訂正報告書は、取得できず反映できない場合があることを知らせる文字列です。同じ文言を HTTP 応答の X-JF-Notice ヘッダーでも返します。データ利用上の注意を参照してください。