iATR()関数は、ATR(Average True Range:真の値幅)の値を取得するために使用します。
iATR()関数は、以下のように定義されています。
double iATR(
string symbol,
int timeframe,
int period,
int shift
);
各引数の意味は、以下のとおりです。
- string symbol
ATRの値を計算する通貨ペア名を指定します。
通貨ペア名は、「気配値表示ウィンドウ」に表示されているとおりに記述します。
特定の通貨ペアを指定せず、EA等を適用したチャートの通貨ペアのATRの値を取得したい場合は、「NULL」と記述します。 - int timeframe
以下の表に従って、ATRの値を計算する時間軸を指定します。種 類 定 数 内 容 PERIOD_CURRENT 0 現在の時間足 PERIOD_M1 1 1分足 PERIOD_M5 5 5分足 PERIOD_M15 15 15分足 PERIOD_M30 30 30分足 PERIOD_H1 60 1時間足 PERIOD_H4 240 4時間足 PERIOD_D1 1440 日 足 PERIOD_W1 10080 週 足 PERIOD_MN1 43200 月 足 - int period
ATRの値を計算する期間を指定します。 - int shift
ATRの値を取得したいバーの位置を指定します。
ATRの値を取得したいバーが現在のバーであれば「0」、1本前のバーであれば「1」、2本前のバーであれば「2」……と記述します。
戻り値
ATRの値が返されます。
具体例
EA等を適用しているチャートにおける1本前のバーのATR(計算期間:バー20本分)の値を取得したい場合は、以下のように記述します。
double ATR_1 = iATR(NULL,0,20,1);