iTime() の使い方・引数・戻り値（MQL4／MQL5）

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 でコンパイルできることを確認済みです。