MQL4MQL5 時系列データ（バー・価格）
iTime()
- できること
- 指定したバーの開始時刻を取得する
- 対応
- MQL4・MQL5
iTime() とは
銘柄・時間足・バーの位置を指定して、そのバーが始まった時刻（サーバー時刻）を返す関数です。「新しい足ができたか」の判定によく使います。
iTime() の書式と引数
MQL4 の場合MT4
datetime iTime(string symbol, int timeframe, int shift)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol | string | 必須 | 銘柄名。チャートの銘柄なら _Symbol（NULL も可）。 |
timeframe | int | 必須 | 時間足。PERIOD_CURRENT（チャートの時間足）、PERIOD_H1、PERIOD_D1 など。 |
shift | int | 必須 | バーの位置。0 が現在（未確定）のバー、1 がひとつ前の確定したバー。 |
戻り値（MQL4）
バーの開始時刻。データがないときは 0。
MQL5 の場合MT5
datetime iTime(
const string symbol,
ENUM_TIMEFRAMES timeframe,
int shift
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol | const string | 必須 | 銘柄名。チャートの銘柄なら _Symbol（NULL も可）。 |
timeframe | ENUM_TIMEFRAMES | 必須 | 時間足。PERIOD_CURRENT（チャートの時間足）、PERIOD_H1、PERIOD_D1 など。 |
shift | int | 必須 | バーの位置。0 が現在（未確定）のバー、1 がひとつ前の確定したバー。 |
戻り値（MQL5）
バーの開始時刻。データがないときは 0。
iTime() の使い方（コード例）
MQL4・MQL5 共通
// 新しい足ができたときだけ true を返す
static datetime last = 0;
datetime t = iTime(_Symbol, PERIOD_CURRENT, 0);
bool isNewBar = (t != 0 && t != last);
if(isNewBar)
{
last = t;
Print("新しい足：", TimeToString(t));
}OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。
MQL4 と MQL5 の違い
MQL4 の Time[shift] にあたります。
