MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のiBarShiftとiTimeの比較

この記事を開いてくださったこと、心から感謝しています。ある時刻の足がどれなのか、プログラムで探したいと考えている人も、きっと多いはずです。

結論から言うと、時刻から足の番号を知りたいときはiBarShift、足の番号から開始時刻を知りたいときはiTimeです。2つは、向きが逆の関係にある関数です。

また、失敗したときの扱いや、テスターでの動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、失敗したときの値、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のiBarShiftとiTimeの違いをまとめたインフォグラフィック
目次

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口座・ツールの比較一覧もあわせて確認してみてください。

  • 時刻から、番号を知りたい
  • 近い足でもよいか、決める
  • -1を、必ず確かめる

番号が手元にあるなら、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の結果を見比べておくと、安心して使えます。

時刻から番号、番号から時刻と、向きが逆だと分かって、すっきりしました。調べてよかったです。
-1と0で失敗の値が違うと知って、確認の大切さが身にしみました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
まずは開始時刻を表示するところから試す流れが分かって、始めるのが楽しみになりました。
  • まず、開始時刻を表示する
  • 次に、番号を探す
  • 最後に、途中の時刻で試す

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

iBarShiftの-1は、どんなときに返るのか?

公式の説明では、exactがtrueで該当する足がないときと、指定した時刻より前の履歴が手元にないときです。それ以外の理由は、記載なしでした。

  • exactがtrueで、足がないとき
  • 指定時刻より前の履歴がないとき
  • ほかの理由は、記載なし

時間足を省略したいときは、どう書くのか?

公式では、いまのチャートの時間足を使うときは、PERIOD_CURRENTを渡す、と説明されています。iTimeのページには、0でもいまの時間足を表す、と書かれています。

  • iBarShiftは、PERIOD_CURRENT
  • iTimeは、0でもよいと書かれている
  • 書き方が、2ページで違う

この記事の例は、実際の結果なのか?

いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。

  • 公式サンプルの内容をもとにした説明
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?」

時刻から足の番号を知るならiBarShift、足の番号から開始時刻を知るならiTimeです。どちらも、失敗の値と記載のない点を、自分の環境で確かめてから使いましょう。

  • 時刻から番号ならiBarShift
  • 番号から時刻ならiTime
  • 失敗の値は-1と0で違う

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(iBarShift)
  • MQL5 リファレンス(iTime)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
  • MQL5のGetTickCountとGetMicrosecondCountの比較
    MQL5のGetTickCountとGetMicrosecondCount、システム起動からの経過ミリ秒を手軽に測れる安心感とプログラム開始からのマイクロ秒を測れる細かさどっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次