MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?

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

この記事を開いてくださったこと、心から感謝しています。チャートの足が何本あるのかを、プログラムで知りたいと考えている人も、きっと多いはずです。

結論から言うと、足の本数を数えたいときはBars、履歴の始まりの日付や同期しているかどうかまで確かめたいときはSeriesInfoIntegerです。返してくれる情報の幅が違う関数です。

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

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

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

BarsとSeriesInfoIntegerは、そもそも何が違うのか?

まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも足の本数に関わりますが、役割の幅が違います。

Barsは、足の本数を数える関数である

Barsは、銘柄の名前と時間足を渡すと、履歴にある足の本数を返す関数です。さらに、開始時刻と終了時刻を渡す形もあり、その期間にある足の本数を返します。

戻り値は、どちらの形も整数です。公式の説明では、足のデータが端末にまだできていないときや、取引サーバーと同期していないときは、0が返ります。

  • 全体の本数を数える形がある
  • 期間を指定して数える形もある
  • 同期前は、0が返る

SeriesInfoIntegerは、履歴の状態を返す関数である

SeriesInfoIntegerは、銘柄の名前、時間足、項目のIDを渡すと、履歴データの状態を返す関数です。足の本数のほかに、最初の日付や、同期の旗なども読めます。

形は2つあります。値をそのまま返す形と、値を変数に入れて、成功か失敗かを返す形です。後者は、失敗したときにエラーの番号を調べるよう、公式で案内されています。

  • 値を、そのまま返す形がある
  • 変数に入れて、成否を返す形もある
  • 足の本数以外の情報も読める

2つを、表で比べる

公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。

項目 Bars SeriesInfoInteger
主な役割 足の本数を数える 履歴の状態を読む
期間を指定する できる 記載なし
戻り値の型 整数 長整数、または成否
同期前の動き 0を返す 値を返す形の失敗値は記載なし
テスターでの動き 記載なし 記載なし

※公式の説明をもとにした、筆者の整理です。

Barsは、どんな場面で使うのか?

Barsは、足が何本あるかを、手早く知りたいときに使います。公式の説明から、動き方を確認します。

期間を指定すると、その中の足だけを数えられる

開始時刻と終了時刻を渡すと、その期間の中にある足の本数が返ります。公式では、足の開き始めの時刻が期間の中に入っているかどうかで、数えるかどうかが決まります。

公式の例では、1時間足で、2時5分から10時55分までを指定すると、8本が返ります。2時の足は入らず、10時の足まで入る、という数え方です。

  • 足の開き始めの時刻で判断する
  • 1時間足の例では、8本が返る
  • 期間の端の扱いは、例で確かめる

日足や週足の例も、公式に載っている

公式には、日足の例もあります。金曜の23時55分から、月曜の0時までを指定すると、月曜の足が入るので、1本が返ります。

週足の例では、週の足の開き始めは、いつも日曜、と説明されています。月曜から木曜までを指定すると、足が入らないため、0が返ります。

  • 日足の例は、1本が返る
  • 週足の足は、日曜に始まる
  • 月曜から木曜は、0本が返る

0が返ったときは、同期を確かめる

公式サンプルは、Barsが0のとき、SeriesInfoIntegerで同期の状態を調べています。最大5回、少し待ってから、もう一度調べる作りです。

0が返る理由は、足ができていない場合と、同期していない場合の2つが書かれています。それ以外の理由があるかどうかは、記載なしです。

  • 0のときは、同期を確かめる
  • 最大5回、少し待つ作り
  • ほかの理由は、記載なし

銘柄と時間足は、引数で自由に指定できる

2つの関数は、どちらも銘柄の名前と時間足を引数で受け取ります。そのため、いま開いているチャートとは別の銘柄や時間足についても、足の本数や履歴の状態を調べられます。

公式の例では、いまのチャートの銘柄と時間足を渡す書き方が使われています。ほかの銘柄を調べるときの注意点は、公式のページには書かれていません。

  • 別の銘柄も、引数で指定できる
  • 別の時間足も、引数で指定できる
  • 別の銘柄の注意点は、記載なし

SeriesInfoIntegerは、どんな場面で使うのか?

SeriesInfoIntegerは、本数以外の情報も含めて、履歴の状態を知りたいときに使います。公式の項目を確認します。

読める項目は、6つある

公式の一覧には、6つの項目があります。足の本数、その時間足の最初の日付、最後の足の時刻、サーバーの最初の日付、端末の最初の日付、同期の旗です。

項目 公式の説明
SERIES_BARS_COUNT いまの足の本数
SERIES_FIRSTDATE その時間足の最初の日付
SERIES_LASTBAR_DATE 最後の足の開始時刻
SERIES_SERVER_FIRSTDATE サーバーにある履歴の最初の日付
SERIES_TERMINAL_FIRSTDATE 端末にある履歴の最初の日付
SERIES_SYNCHRONIZED 同期しているかどうかの旗

※公式の説明をもとにした、筆者の整理です。

サーバーの履歴と、端末の履歴を見分けられる

サーバーの最初の日付と、端末の最初の日付は、時間足に関係なく、銘柄の履歴の最初を表します。端末にどこまで届いているかを、サーバーと見比べて確かめられます。

ただし、2つの日付が違うときに、端末がどう動くかは、公式のページには書かれていません。履歴を取り込む仕組みは、CopyTicksとCopyTicksRangeの記事でも触れています。

  • サーバー側の最初の日付が読める
  • 端末側の最初の日付も読める
  • 違うときの動きは、記載なし

失敗したときの値は、形によって違う

変数に入れる形は、項目が使えれば、変数に値が入ってtrueが返ります。使えなければ、falseです。エラーの原因は、GetLastErrorで調べます。

値をそのまま返す形が、失敗したときに何を返すのかは、公式のページに書かれていません。失敗を確実に見分けたいときは、変数に入れる形が向いています。

  • 変数に入れる形は、成否が分かる
  • 値を返す形の失敗値は、記載なし
  • 確実に見分けるなら、変数に入れる形

BarsとSERIES_BARS_COUNTは、同じ本数になるのか?

足の本数は、どちらでも読めるので、気になる人も多いはずです。公式の説明をもとに、分かることと、分からないことを整理します。

どちらも、いまの足の本数を表す

Barsは、履歴にある足の本数を返し、SERIES_BARS_COUNTは、いまの足の本数を表します。言葉の上では、同じものを指しているように読めます。

  • Barsは、履歴の足の本数
  • SERIES_BARS_COUNTは、いまの足の本数
  • 型は、整数と長整数で違う

同じ値になるかは、記載がない

2つが、いつも同じ値を返すのか、更新のタイミングが同じなのかは、公式のページには書かれていません。キャッシュされるのか、呼ぶたびに更新されるのかも、記載なしです。

そのため、どちらを使うかを決めたら、同じプログラムの中では、同じ方を使い続けるのが安心です。2つを混ぜて比べるときは、実際の値を表示して確かめましょう。

  • 同じ値になるかは、記載なし
  • 更新のタイミングも、記載なし
  • プログラム内では、片方に揃える

どう使い分ければよいのか?

足の本数だけが知りたいなら、Barsが手軽です。履歴の状態まで確かめたいなら、SeriesInfoIntegerが向いています。

本数だけなら、Barsを選ぶ

全体の本数や、ある期間の本数を、すぐに知りたいときは、Barsが向いています。引数が少なく、呼び出しも短く書けます。

FX口座・ツールの比較一覧もあわせて確認してみてください。

  • 全体の足の本数を知りたい
  • 期間の足の本数を知りたい
  • 短く書きたい

履歴の状態まで知りたいなら、SeriesInfoIntegerを選ぶ

履歴の最初の日付や、同期の状態も確かめたいときは、SeriesInfoIntegerが向いています。0が返ったときの原因を探すときにも役立ちます。

  • 履歴の最初の日付を知りたい
  • 同期の状態を確かめたい
  • 0が返った原因を探したい

どちらも、テスターでの動きは記載がない

公式のページには、ストラテジーテスターでの動きは、書かれていません。履歴の取り込みが始まるかどうかも、記載がありませんでした。

  • テスターでの動きは、記載なし
  • 取り込みが始まるかは、記載なし
  • 自分の環境で、確かめてから使う

実際に使うとき、どんな順番で進めればよいのか?

最後に、確認の順番を整理します。まずは、スクリプトで、値を表示して確かめるのが安心です。

まずは、Barsで本数を表示する

最初は、いまのチャートの銘柄と時間足で、Barsを呼んで、本数をログに出します。0が返ってきたときは、少し待って、もう一度試します。

  • いまのチャートで、本数を表示する
  • 0なら、少し待って試す
  • ログで、結果を確かめる

次に、SeriesInfoIntegerで状態を表示する

次に、6つの項目を、順に読んで、ログに表示します。日付の項目は、時刻の型にして表示すると、見やすくなります。

  • 6つの項目を、順に読む
  • 日付は、時刻の型で表示する
  • 同期の旗も、確かめる

最後に、本数を比べて確かめる

Barsと、SERIES_BARS_COUNTを、同じ場面で読んで、値を見比べます。公式に記載のない点は、こうして自分の環境で確かめておくと、安心して使えます。

本数だけならBars、状態まで知るならSeriesInfoIntegerと分かって、迷わず選べそうです。調べてよかったです。
0が返る理由が公式に書かれていると知って、確認の大切さが身にしみました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
まずは本数を表示するところから試す流れが分かって、始めるのが楽しみになりました。
  • まず、本数を表示する
  • 次に、状態を表示する
  • 最後に、見比べて確かめる

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

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

Barsが0を返すのは、どんなときなのか?

公式の説明では、足のデータが端末にまだできていないときや、取引サーバーと同期していないときです。それ以外の理由は、記載なしでした。

  • 足が、まだできていないとき
  • 同期していないとき
  • ほかの理由は、記載なし

SeriesInfoIntegerは、整数以外も読めるのか?

この関数は、整数の項目を読む関数です。日付や旗も、整数の型で返り、必要に応じて時刻や真偽の型に変えて使います。公式の例も、そう書かれています。

  • 整数の項目を読む関数
  • 日付や旗は、型を変えて使う

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

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

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

まとめ:「MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?」

足の本数だけならBars、履歴の始まりや同期の状態まで確かめるならSeriesInfoIntegerです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。

  • 本数だけならBars
  • 状態まで知るならSeriesInfoInteger
  • 記載なしの点は自分で確かめる

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

出典・参照元

  • MQL5 リファレンス(Bars)
  • MQL5 リファレンス(SeriesInfoInteger)
  • MQL5 リファレンス(履歴データベースのプロパティ)

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

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

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

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

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

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

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    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つのサインと使い方の注意点
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
  • セントラル短資FXとLIGHT 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と人工知能の力.

目次