経済指標カレンダー構造体

このセクションでは、MetaTraderプラットフォームで直接利用可能な経済指標カレンダーを使用するための構造体について説明します。経済指標カレンダーは、マクロ経済指標、その発表日および重要度の説明を含む既製の「百科事典」です。関連するマクロ経済指標の値は、発行直後にメタトレーダープラットフォームに送信され、国、通貨、重要度ごとに必要な指標を視覚的に追跡できるタグとしてチャートに表示されます。

経済指標カレンダー関数を使用すると、必要な国/通貨ペアの観点から、カスタム重要度基準に従って、着信したイベントの自動分析を実行できます。

国の説明はMqlCalendarCountry構造体で設定されます。これはCalendarCountryById()およびCalendarCountries()関数で使用されます。

struct MqlCalendarCountry
 {
  ulong                               id;                   // 国ID(ISO 3166-1)
  string                             name;                 // 国名(現在のターミナルエンコーディング)
  string                             code;                 // 国コード名(ISO 3166-1 alpha-2)
  string                             currency;             // 国の通貨コード
  string                             currency_symbol;       // 国の通貨の銘柄
  string                             url_name;             // mql5.comウェブサイトURLに使用される国名
 };

 

イベントの説明はMqlCalendarEvent構造体で設定されます。これはCalendarEventById()CalendarEventByCountry()CalendarEventByCurrency()関数で使用されます。

struct MqlCalendarEvent
 {
  ulong                               id;                   // イベントID
  ENUM_CALENDAR_EVENT_TYPE           type;                 // ENUM_CALENDAR_EVENT_TYPE列挙対からのイベントタイプ
  ENUM_CALENDAR_EVENT_SECTOR         sector;               // イベントが関連する部門
  ENUM_CALENDAR_EVENT_FREQUENCY     frequency;             // イベントの頻度
  ENUM_CALENDAR_EVENT_TIMEMODE       time_mode;             // イベント時間モード
  ulong                               country_id;           // 国ID
  ENUM_CALENDAR_EVENT_UNIT         unit;                 // 経済指標値の単位
  ENUM_CALENDAR_EVENT_IMPORTANCE     importance;           // イベントの重要度
  ENUM_CALENDAR_EVENT_MULTIPLIER     multiplier;           // 経済指標値の乗数
  uint                               digits;               // 小数点以下の桁数
  string                             source_url;           // イベント発表源のURL
  string                             event_code;           // イベントコード
  string                             name;                 // イベント名(現在のターミナルエンコーディング)
 };

 

イベント値はMqlCalendarValue構造体で設定されます。これはCalendarValueById()CalendarValueHistoryByEvent()CalendarValueHistory()CalendarValueLastByEvent()CalendarValueLast()関数で使用されます。

struct MqlCalendarValue
 {
  ulong                               id;                   // 値ID
  ulong                               event_id;             // イベントID
  datetime                           time;                 // イベント日時
  datetime                           period;               // イベント報告期間
  int                                 revision;             // 報告期間に関連して発表された指標の改訂
  long                               actual_value;         // 実際の指標値
  long                               prev_value;           // 以前の指標値
  long                               revised_prev_value;   // 改正された以前の指標値
  long                               forecast_value;       // 指標の予測値
  ENUM_CALENDAR_EVENT_IMPACT         impact_type;           // 為替レートへの潜在的影響
 };

 

イベント頻度はMqlCalendarEvent構造体で設定されます。可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_FREQUENCY

ID

説明

CALENDAR_FREQUENCY_NONE

Release frequency is not set

CALENDAR_FREQUENCY_WEEK

Released once a week

CALENDAR_FREQUENCY_MONTH

Released once a month

CALENDAR_FREQUENCY_QUARTER

Released once a quarter

CALENDAR_FREQUENCY_YEAR

Released once a year

CALENDAR_FREQUENCY_DAY

Released once a day

 

Event type is specified in the MqlCalendarEvent structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_TYPE

ID

説明

CALENDAR_TYPE_EVENT

Event (meeting, speech, etc.)

CALENDAR_TYPE_INDICATOR

Indicator

CALENDAR_TYPE_HOLIDAY

Holiday

 

A sector of the economy an event is related to is specified in the MqlCalendarEvent structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_SECTOR

ID

説明

CALENDAR_SECTOR_NONE

Sector is not set

CALENDAR_SECTOR_MARKET

Market, exchange

CALENDAR_SECTOR_GDP

国内総生産(Gross Domestic Product、GDP)

CALENDAR_SECTOR_JOBS

Labor market

CALENDAR_SECTOR_PRICES

Prices

CALENDAR_SECTOR_MONEY

Money

CALENDAR_SECTOR_TRADE

取引

CALENDAR_SECTOR_GOVERNMENT

Government

CALENDAR_SECTOR_BUSINESS

Business

CALENDAR_SECTOR_CONSUMER

Consumption

CALENDAR_SECTOR_HOUSING

Housing

CALENDAR_SECTOR_TAXES

Taxes

CALENDAR_SECTOR_HOLIDAYS

Holidays

 

Event importance is specified in the MqlCalendarEvent structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_IMPORTANCE

ID

説明

CALENDAR_IMPORTANCE_NONE

Importance is not set

CALENDAR_IMPORTANCE_LOW

Low importance

CALENDAR_IMPORTANCE_MODERATE

Medium importance

CALENDAR_IMPORTANCE_HIGH

High importance

 

Measurement unit type used in displaying event values is specified in the MqlCalendarEvent structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_UNIT

ID

説明

CALENDAR_UNIT_NONE

Measurement unit is not set

CALENDAR_UNIT_PERCENT

Percentage

CALENDAR_UNIT_CURRENCY

National currency

CALENDAR_UNIT_HOUR

Hours

CALENDAR_UNIT_JOB

Jobs

CALENDAR_UNIT_RIG

Drilling rigs

CALENDAR_UNIT_USD

USD

CALENDAR_UNIT_PEOPLE

People

CALENDAR_UNIT_MORTGAGE

Mortgage loans

CALENDAR_UNIT_VOTE

Votes

CALENDAR_UNIT_BARREL

Barrels

CALENDAR_UNIT_CUBICFEET

Cubic feet

CALENDAR_UNIT_POSITION

Non-commercial net positions

CALENDAR_UNIT_BUILDING

Buildings

 

In some cases, economic parameter values require a multiplier set in the MqlCalendarEvent structure. Possible multiplier values are set in the listing ENUM_CALENDAR_EVENT_MULTIPLIER

ID

説明

CALENDAR_MULTIPLIER_NONE

Multiplier is not set

CALENDAR_MULTIPLIER_THOUSANDS

Thousands

CALENDAR_MULTIPLIER_MILLIONS

Millions

CALENDAR_MULTIPLIER_BILLIONS

Billions

CALENDAR_MULTIPLIER_TRILLIONS

Trillions

 

Event's potential impact on a national currency rate is indicated in the MqlCalendarValue structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_IMPACT

ID

説明

CALENDAR_IMPACT_NA

Impact is not set

CALENDAR_IMPACT_POSITIVE

Positive impact

CALENDAR_IMPACT_NEGATIVE

Negative impact

 

Event time is specified in the MqlCalendarEvent structure. 可能な値はリストで設定されます。ENUM_CALENDAR_EVENT_TIMEMODE

ID

説明

CALENDAR_TIMEMODE_DATETIME

ソースはイベントの正確な時間を公開します

CALENDAR_TIMEMODE_DATE

終日イベント

CALENDAR_TIMEMODE_NOTIME

ソースはイベントの時間を公開しない

CALENDAR_TIMEMODE_TENTATIVE

ソースはイベントの日を公開するが時間を公開しません。時間はイベントの発生時に指定されます。

 

参照

経済指標カレンダー