iBands()関数は、ボリンジャーバンド(Bollinger Band)の値を取得するために使用します。
iBands()関数は、以下のように定義されています。
double iBands(
string symbol,
int timeframe,
int period,
double deviation,
int bands_shift,
int applied_price,
int mode,
int shift
);
各引数の意味は、以下のとおりです。
- string symbol
ボリンジャーバンドの値を計算する通貨ペア名を指定します。
通貨ペア名は、「気配値表示ウィンドウ」に表示されているとおりに記述します。
特定の通貨ペア名を指定せず、EA等を適用したチャートの通貨ペアのボリンジャーバンドの値を取得したい場合は、「NULL」と記述します。 - int timeframe
以下の表に従って、ボリンジャーバンドの値を計算する時間軸を指定します。種 類 定 数 内 容 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
中間線の値を計算する期間を指定します。 - double deviation
上方バンドと下方バンドの値は、以下の計算式により算出されます。
上方バンド:中間線の値 +(標準偏差 × 掛け率)
下方バンド:中間線の値 -(標準偏差 × 掛け率)
この引数では、上記計算式の「掛け率」の値を指定します。 - int bands_shift
ボリンジャーバンドの表示を右方向にシフト(ずらす)するバーの個数を指定します。 - int applied_price
以下の表に従って、ボリンジャーバンドの値の計算に使用する価格データを指定します。種 類 定 数 内 容 PRICE_CLOSE 0 終 値 PRICE_OPEN 1 始 値 PRICE_HIGH 2 高 値 PRICE_LOW 3 安 値 PRICE_MEDIAN 4 中央値
(高値+安値)÷2PRICE_TYPICAL 5 代表値
(高値+安値+終値)÷3PRICE_WEIGHTED 6 加重終値
(高値+安値+終値+終値)÷4 - int mode
ライン番号を指定します。
中間線の値を取得したい場合は「0」と記述します。
上方バンドの値を取得したい場合は「1」と記述します。
下方バンドの値を取得したい場合は「2」と記述します。 - int shift
ボリンジャーバンドの値を取得したいバーの位置を指定します。
ボリンジャーバンドの値を取得したいバーが現在のバーであれば「0」、1本前のバーであれば「1」、2本前のバーであれば「2」……と記述します。
戻り値
第7引数に指定した値に従って、ボリンジャーバンドを構成する各ラインの値が返されます。
具体例
「EUR/USD」(=ユーロ/ドル)の1時間足チャートにおける終値を基準とした現在の上方バンドの値を取得したい場合は、以下のように記述します。
double Upper = iBands(“EURUSD”,PERIOD_H1,20,3,PRICE_CLOSE,1,0);