この記事を開いてくださったこと、心から感謝しています。ある時刻の足がどれなのか、プログラムで探したいと考えている人も、きっと多いはずです。
結論から言うと、時刻から足の番号を知りたいときはiBarShift、足の番号から開始時刻を知りたいときはiTimeです。2つは、向きが逆の関係にある関数です。
また、失敗したときの扱いや、テスターでの動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、失敗したときの値、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
iBarShiftとiTimeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも足を扱いますが、渡すものと返るものが入れ替わっています。
iBarShiftは、時刻から足の番号を探す関数である
iBarShiftは、銘柄の名前、時間足、時刻を渡すと、その時刻にあたる足の番号を返す関数です。番号は、いまの足から数えた位置を表します。
四つ目の引数exactは、省略するとfalseです。該当する足がないときの動きを、このexactで切り替えます。
- 銘柄、時間足、時刻を渡す
- 足の番号が、戻り値で返る
- exactで、探し方を切り替える
iTimeは、足の番号から開始時刻を取り出す関数である
iTimeは、銘柄の名前、時間足、足の番号を渡すと、その足の開始時刻を返す関数です。番号は、いまの足から数えた位置で、いまの足が0番にあたります。
つまり、iBarShiftで時刻から番号を求め、その番号をiTimeに渡すと、足の開始時刻が分かる、という流れで組み合わせられます。公式のサンプルも、この流れで書かれています。
- 銘柄、時間足、足の番号を渡す
- 足の開始時刻が、戻り値で返る
- iBarShiftと、向きが逆の関係
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | iBarShift | iTime |
|---|---|---|
| 渡すもの | 時刻 | 足の番号 |
| 返るもの | 足の番号 | 足の開始時刻 |
| 失敗したときの値 | -1 | 0 |
| 探し方の切り替え | exactがある | なし |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
iBarShiftは、どんな場面で使うのか?
iBarShiftは、決まった時刻の足を、番号で指したいときに使います。公式の説明から、動き方を確認します。
exactがfalseなら、近い足の番号が返る
exactがfalseのとき、指定した時刻に足がなければ、近い足の番号が返ります。公式では、開始時刻が指定時刻より前の、いちばん近い足と説明されています。
たとえば、日曜のように相場が動かない時間を渡しても、直前の金曜の足の番号が返ります。公式のサンプルでも、日曜の昼の時刻を渡して、金曜の足が見つかる例が載っています。
- 近い足の番号が返る
- 開始時刻が、指定時刻より前の足
- 日曜を渡すと、金曜の足になる例がある
exactがtrueなら、足がないとき-1が返る
exactをtrueにすると、近い足を探さなくなります。該当する足がないときは、-1が返ります。公式のサンプルでも、同じ日曜の時刻で-1が返る例があります。
時刻ぴったりの足があるかどうかを確かめたいときは、trueが向いています。ただし、足の途中の時刻を渡したときの扱いは、公式のページに書かれていません。
- 近い足は探さない
- 足がないと、-1が返る
- 足の途中の時刻は、記載なし
履歴が足りないときも、-1が返る
exactがfalseでも、指定した時刻より前の履歴が手元にないときは、-1が返ります。履歴が足りないときの、ほかの対処は、公式のページに書かれていません。
-1を、そのまま足の番号として使うのは危険です。番号を使う前に、-1かどうかを必ず確かめる、という書き方が安心です。
- 履歴が足りないと、-1が返る
- -1は、足の番号として使わない
- 使う前に、-1かどうかを確かめる
iTimeは、どんな場面で使うのか?
iTimeは、足の番号から、その足がいつ始まったのかを知りたいときに使います。公式の説明から、動き方を確認します。
いまの足は0番、1つ前の足は1番になる
足の番号は、いまの足が0番で、過去に進むほど大きくなります。たとえば、1つ前の足の開始時刻を知りたいなら、番号に1を渡します。
取り出せるのは、開始時刻です。足が終わる時刻は、この関数では返りません。終わる時刻の求め方は、公式のページに書かれていません。
- いまの足は、0番
- 1つ前の足は、1番
- 取れるのは、開始時刻
失敗したときは、0が返る
iTimeは、失敗すると0を返します。詳しい原因は、GetLastErrorで調べるよう、公式で案内されています。具体的なエラー番号の一覧は、記載なしでした。
番号が履歴の範囲を超えたときや、負の番号を渡したときに何が返るのかも、公式のページには書かれていません。そのため、0が返ったときは、まず番号が正しいかを疑います。
- 失敗すると、0が返る
- 原因は、GetLastErrorで調べる
- 負の番号の扱いは、記載なし
呼ぶたびに、新しい値を取りに行く
公式の注意書きには、この関数は、いつも最新のデータを返すと書かれています。呼ぶたびに、時系列へ問い合わせる、という説明です。
最初の呼び出しで、データの準備が間に合わないときは、結果が出るまで少し時間がかかることがある、とも書かれています。前の結果を保存しておく仕組みは、ないと説明されています。
- いつも、最新のデータを返す
- 準備に、時間がかかることがある
- 前の結果は、保存されない
2つを組み合わせると、どう動くのか?
2つは、組み合わせて使うことが多い関数です。公式サンプルの流れをもとに、整理します。
時刻、番号、開始時刻の順に進む
まず、iBarShiftで、指定した時刻の足の番号を求めます。次に、その番号をiTimeに渡して、足の開始時刻を取り出します。公式のサンプルも、この順番です。
この流れを使うと、「指定した時刻は、どの足に入っているのか」を、足の開始時刻として確かめられます。日曜の時刻を渡して、金曜の開始時刻が返る例が、その説明にあたります。
- iBarShiftで、番号を求める
- iTimeで、開始時刻を取り出す
- 指定時刻が、どの足に入るか分かる
公式サンプルには、気になる点がある
公式サンプルを読むと、気になる点がいくつかありました。iBarShiftのページのコードは、2002年の日付を使い、コメントには日曜と書かれています。一方で、その日付は、暦の上では木曜になります。
また、結果の表示は2018年の日曜になっていて、コードの日付と合いません。こうした食い違いがあるため、公式の数字をそのまま信じず、自分の環境で動かして確かめるのが安心です。
さらに、サンプルは、-1かどうかを確かめずに、iTimeへ番号を渡しています。実際に使うときは、この確認を足しておくのが安全です。
- サンプルの日付に、食い違いがある
- 結果の表示が、コードと合わない
- -1の確認は、自分で足す
どう使い分ければよいのか?
時刻から足を探したいならiBarShift、番号から時刻を知りたいならiTimeです。手元にあるものが何かで、決まります。
時刻が手元にあるなら、iBarShiftを選ぶ
決まった時刻の足を、番号で指したいときは、iBarShiftが向いています。たとえば、ある日の始値の足を探す、といった場面です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
番号が手元にあるなら、iTimeを選ぶ
ループで足を順に見ていて、その足がいつなのかを知りたいときは、iTimeが向いています。ログに時刻を出して、動きを確かめるときにも役立ちます。
- 番号から、開始時刻を知りたい
- ループの中で、時刻を確かめたい
- 0が返ったら、番号を疑う
値をまとめて取りたいなら、別の関数も候補になる
多くの足の時刻を、まとめて取りたいときは、1本ずつiTimeを呼ぶより、まとめて配列に取る関数のほうが向く場合があります。iTimeのページの関連項目にも、CopyTimeとCopyRatesが載っています。
足の情報をまとめて取る関数との違いは、CopyRatesとiCloseの記事で整理しています。どちらが速いかは、公式のページには書かれていません。
- まとめて取るなら、CopyTimeも候補
- 関連項目に、CopyTimeとCopyRates
- 速さの比較は、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、値を表示して確かめるのが安心です。
まずは、iTimeで足の開始時刻を表示する
最初は、番号0と番号1で、iTimeを呼んで、開始時刻をログに出します。0が返ってきたときは、銘柄や時間足の指定を見直します。
- 番号0と1で、時刻を表示する
- 0なら、指定を見直す
- ログで、結果を確かめる
次に、iBarShiftで番号を探す
次に、先ほど出した開始時刻を、そのままiBarShiftに渡して、番号が戻ってくるかを確かめます。exactをfalseとtrueの両方で試すと、違いがよく分かります。
- 開始時刻を、iBarShiftに渡す
- falseとtrueの両方で試す
- -1かどうかを、確かめる
最後に、足の途中の時刻でも試す
足の途中の時刻を渡したときの動きは、公式に記載がありません。そのため、自分の環境で、falseとtrueの結果を見比べておくと、安心して使えます。









- まず、開始時刻を表示する
- 次に、番号を探す
- 最後に、途中の時刻で試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
iBarShiftの-1は、どんなときに返るのか?
公式の説明では、exactがtrueで該当する足がないときと、指定した時刻より前の履歴が手元にないときです。それ以外の理由は、記載なしでした。
- exactがtrueで、足がないとき
- 指定時刻より前の履歴がないとき
- ほかの理由は、記載なし
時間足を省略したいときは、どう書くのか?
公式では、いまのチャートの時間足を使うときは、PERIOD_CURRENTを渡す、と説明されています。iTimeのページには、0でもいまの時間足を表す、と書かれています。
- iBarShiftは、PERIOD_CURRENT
- iTimeは、0でもよいと書かれている
- 書き方が、2ページで違う
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?」
時刻から足の番号を知るならiBarShift、足の番号から開始時刻を知るならiTimeです。どちらも、失敗の値と記載のない点を、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










