この記事を開いてくださったこと、心から感謝しています。チャートの足が何本あるのかを、プログラムで知りたいと考えている人も、きっと多いはずです。
結論から言うと、足の本数を数えたいときはBars、履歴の始まりの日付や同期しているかどうかまで確かめたいときはSeriesInfoIntegerです。返してくれる情報の幅が違う関数です。
また、失敗したときの値や、テスターでの動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、取れる項目、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
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が0を返すのは、どんなときなのか?
公式の説明では、足のデータが端末にまだできていないときや、取引サーバーと同期していないときです。それ以外の理由は、記載なしでした。
- 足が、まだできていないとき
- 同期していないとき
- ほかの理由は、記載なし
SeriesInfoIntegerは、整数以外も読めるのか?
この関数は、整数の項目を読む関数です。日付や旗も、整数の型で返り、必要に応じて時刻や真偽の型に変えて使います。公式の例も、そう書かれています。
- 整数の項目を読む関数
- 日付や旗は、型を変えて使う
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?」
足の本数だけならBars、履歴の始まりや同期の状態まで確かめるならSeriesInfoIntegerです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










