5. 履歴データ型 — DataType オブジェクト

DataType describes a single historical data type as a triplet of name + frequency + asset type—the common language for the data pipeline and for strategies to declare data needs. qteasy ships many built-in DataType インスタンスを作成し、文書化されたインターフェイスを介してユーザー定義型をサポートします。

class qteasy.DataType(name: str = '', *, freq: Optional[str] = None, asset_type: Optional[str] = None)[ソース]

単一の履歴データタイプ (名前、頻度、資産タイプ) を記述するための qteasy のコアオブジェクト。

各 DataType is uniquely defined by name, freq, and asset_type. Use it to declare strategy data needs, drive internal fetch flows such as get_history_data_from_source() を拡張し、必要に応じてカスタムタイプを拡張します。完全なタイプテーブルとカスタマイズワークフローについては、「DataType と履歴データタイプ管理」の章を参照してください。

サンプル

以下の例は、DataType class name (stable output). When creating a DataType, provide name/freq/asset_type を示しています。

>>> import qteasy as qt
>>> qt.DataType.__name__
'DataType'

property asset_type: str: アセットタイプの文字列形式。例: ⟦コード0⟧⟦コード1⟧⟦コード2⟧

property asset_type_str: str: アセットタイプの文字列形式。例: ⟦コード0⟧⟦コード1⟧⟦コード2⟧

property asset_types: list: 使用中のユーザー定義のアセットタイプのリスト

property data_table_names: ユーザー定義名を優先してテーブル名を解決します。何も定義されていない場合は、組み込みのテーブル名に戻ります。

property dtype_id: 例: close_E_d

get_available_time(asset_type=None) → Optional[str][ソース]

このデータタイプが利用可能になる時刻 (例: 15:00 に閉店、9:30 にオープン。日中タイプには固定時間がない場合があります)。

5. Properties

asset_type: str: 'E', 'IDX', 'FD' などのアセットタイプ。マルチアセットサポートでは、アセットタイプを指定して、対応する可用性時間を取得します。

get_data_from_source(datasource, *, symbols: Optional[str] = None, starts: Optional[Union[str, Timestamp]] = None, ends: Optional[Union[str, Timestamp]] = None)[ソース]

型の取得モードに応じた DataType to fetch data from DataSource のメソッド。

symbols が None の場合は、シンボル化されていないデータを返します。それ以外の場合はシンボル化されたデータ。

パラメータ:

datasource (DataSource) -- データ型オブジェクト
symbols (str) -- カンマ区切りの共有コード。例: ⟦コード0⟧
starts (str) -- 開始日、YYYYMMDD 形式
ends (str) -- 終了日、YYYYMMDD 形式

property id: close(E) のような周波数に依存しない ID、さまざまな資産タイプのデータをマーキング

property unsymbolized: return True if this data type is unsymbolized data type (i.e. reference data type)