この記事を開いてくださったこと、心から感謝しています。チャートの通貨ペアや時間足を、プログラムから調べたいと考えている人も多いはずです。
結論から言うと、通貨ペアの名前が欲しいならChartSymbol、時間足が欲しいならChartPeriodです。どちらもチャートIDを渡して使い、存在しないチャートを渡したときの戻り値も公式に書かれています。
ただし、エラーコードの扱いや、カスタム銘柄での動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・戻り値・公式サンプル・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ChartSymbolとChartPeriodは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。引数の形は同じで、返す値の種類が違います。
ChartSymbolは、通貨ペア名を返す
MQL5公式リファレンスによると、ChartSymbolは、指定したチャートの通貨ペア名を返す関数です。戻り値はstring型です。
引数はチャートIDが1つで、long型です。省略したときの初期値は0で、0は現在のチャートを意味すると書かれています。
- チャートの通貨ペア名を返す
- 戻り値はstring型
- 引数のIDの初期値は0(現在のチャート)
ChartPeriodは、時間足を返す
ChartPeriodは、指定したチャートの時間足を返す関数です。戻り値はENUM_TIMEFRAMES型で、列挙型の値のどれか1つが返ります。
引数はChartSymbolと同じで、チャートIDが1つです。初期値は0で、0は現在のチャートを意味します。
- チャートの時間足を返す
- 戻り値はENUM_TIMEFRAMES型
- 引数のIDの初期値は0(現在のチャート)
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ChartSymbol | ChartPeriod |
|---|---|---|
| 返すもの | 通貨ペア名 | 時間足 |
| 戻り値の型 | string | ENUM_TIMEFRAMES |
| 引数 | チャートID(初期値0) | チャートID(初期値0) |
| 存在しないチャート | 空の文字列を返す | 0を返す |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
存在しないチャートを渡すと、どうなるのか?
2つの関数は、存在しないチャートのIDを渡したときの戻り値が、公式ページにはっきり書かれています。ここが、前の記事で扱った関数との違いです。
ChartSymbolは、空の文字列を返す
公式ページには、チャートが存在しないときは、結果が空の文字列になる、と書かれています。空の文字列は、通貨ペア名としては成り立たないため、判定に使いやすい値です。
- 存在しないチャートでは空の文字列
- 空かどうかで、存在を確かめられる
- 通貨ペア名としては成り立たない値
ChartPeriodは、0を返す
ChartPeriodは、チャートが存在しないときは0を返すと書かれています。公式サンプルでも、0かどうかで存在を判定しています。
ただし、0が正規の時間足の値としても使われるのかどうかは、確認したページには記載なしでした。判定に使うときは、この点を頭に置いておきましょう。
| 確認できること | 確認できないこと |
|---|---|
| 存在しないときの戻り値 | エラーコードの扱い |
| 引数の初期値は0 | 負のIDを渡したときの動き |
| サンプルで存在判定をしている | カスタム銘柄での動き |
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
公式のサンプルは、どう書かれているのか?
2つの公式サンプルは、とてもよく似た作りです。現在のチャート、IDを指定したチャート、存在しないチャートの3つを調べます。
3つのパターンを、順に調べる
サンプルは、まず引数なしで呼び出して、現在のチャートの値を表示します。次に、ChartID関数で現在のチャートのIDを取得して、そのIDを渡した結果を表示します。
最後に、1234567890という、存在しないIDを渡します。結果が空の文字列、またはChartPeriodなら0のとき、そのチャートは存在しない、と表示する流れです。
- 引数なしで、現在のチャートを調べる
- ChartIDで取ったIDを渡して調べる
- 存在しないIDを渡して、判定を確かめる
コメントの出力例では、現在のチャートが示される
ChartSymbolのコメントには、GBPUSDの例が書かれています。ChartPeriodのコメントには、15分足を示すPERIOD_M15の例が書かれています。
チャートIDの数字は、環境ごとに変わる例の値です。同じ数字が表示されるとは限らないため、あくまで形の目安として見るのが安全です。
| 手順 | やっていること |
|---|---|
| 1 | 引数なしで現在のチャートを調べる |
| 2 | ChartIDで現在のIDを取る |
| 3 | IDを渡して結果を表示する |
| 4 | 存在しないIDを渡す |
| 5 | 空か0なら、存在しないと表示する |
※公式のサンプルの流れを、筆者が整理しました。
戻り値は、どう扱えばよいのか?
2つの関数が返す値は、型が違うため、表示や比較のしかたも少し変わります。公式サンプルで確認できる範囲で、整理しておきます。
通貨ペア名は、そのまま文字列として表示できる
ChartSymbolの戻り値はstring型なので、サンプルのように、書式を使った表示にそのまま渡せます。チャートIDは、%I64dという書式で表示されています。
空の文字列かどうかは、比較する書き方で調べます。サンプルでは、空の文字列と等しいかどうかで、存在しないチャートを見分けています。
- 文字列として、そのまま表示できる
- 空の文字列との比較で、存在を判定する
- IDの表示には、%I64dの書式を使う
時間足は、列挙型の名前に直して表示する
ChartPeriodの戻り値は列挙型の値なので、そのままでは数値に近い扱いです。サンプルでは、EnumToString関数で、PERIOD_M15のような名前に直して表示しています。
前の記事のサンプルでは、この名前の先頭7文字を取り除いて、M1のように短く表示していました。必要なら、同じ工夫を加えられますが、これは表示を整えるための書き方です。
| 戻り値 | 表示のしかた | 存在判定 |
|---|---|---|
| 通貨ペア名(string) | そのまま表示できる | 空の文字列と比べる |
| 時間足(ENUM_TIMEFRAMES) | EnumToStringで名前に直す | 0と比べる |
| チャートID(long) | %I64dで表示する | ― |
※公式のサンプルの内容を、筆者が整理しました。
判定のしかたは、公式に書かれた範囲で使う
ここまでの判定方法は、どれも公式ページとサンプルに書かれた範囲のものです。カスタム銘柄や、特殊な時間足での動きは、記載なしのため、自分の環境で確かめる必要があります。
- 公式に書かれた判定方法を使う
- 記載のない場合は、自分で確かめる
- 結果は、まずログに出して確認する
2つを組み合わせると、何ができるのか?
2つの関数は、片方だけでなく、組み合わせて使う場面が多くなります。通貨ペアと時間足の組みで、チャートを特定できるためです。
チャートの身元を、2つの値で表す
チャートIDだけでは、どのチャートなのかが人には分かりにくくなります。通貨ペア名と時間足を合わせると、画面上のチャートと対応づけやすくなります。
前の記事で扱ったChartFirstとChartNextの公式サンプルも、IDから通貨ペアと時間足を調べて表示する作りでした。詳しくは、ChartFirstとChartNextの記事で整理しています。
- IDから、通貨ペア名を調べる
- IDから、時間足を調べる
- 2つを並べて、チャートを見分ける
変更や削除の前に、対象を確認する
チャートを閉じる前に、その通貨ペアと時間足を確認しておくと、間違いを減らせます。閉じる関数については、ChartOpenとChartCloseの記事で整理しています。
なお、存在を確かめたあとに、チャートが閉じられる可能性までは、公式ページに記載なしです。確認直後の操作でも、戻り値は毎回見ておきましょう。
| 場面(仮) | 使う関数 |
|---|---|
| チャートの通貨ペアを知る | ChartSymbol |
| チャートの時間足を知る | ChartPeriod |
| 閉じる前に身元を確かめる | 両方を組み合わせる |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つは競合する関数ではなく、同じ形の姉妹関数です。そのため、どちらを選ぶかは、欲しい情報が通貨ペアか時間足かで決まります。
通貨ペア名が欲しいなら、ChartSymbolを選ぶ
チャートの通貨ペア名を文字列として扱いたいときは、ChartSymbolが向いています。空の文字列で存在を判定できるため、確認もしやすいです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
時間足が欲しいなら、ChartPeriodを選ぶ
チャートの時間足を、列挙型の値として扱いたいときは、ChartPeriodが向いています。サンプルのように、EnumToStringで名前に直して表示することもできます。
- 時間足を列挙型で使いたい
- 0で存在を判定したい
- 名前に直して表示したい
小さく試して、動きを確かめる
いきなり複雑な処理を作らず、公式サンプルのように、現在のチャートの通貨ペアと時間足を表示するところから始めましょう。









もう1つのコツは、渡すチャートIDを、変数に入れて名前を付けておくことです。どのチャートの値なのかが、あとから読み返しても分かりやすくなります。
- チャートIDは、変数に入れて使う
- 結果は、まずログに出して確かめる
- 存在判定の結果を、必ず確認する
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
引数なしで呼ぶと、どのチャートが対象なのか?
チャートIDの初期値は0で、0は現在のチャートを意味します。そのため、引数なしでは現在のチャートが対象です。
- 引数なしは、現在のチャート
- 0を明示しても、同じ意味
エラーコードは、どうなるのか?
2つのページには、エラーコードやGetLastErrorの扱いは、記載なしでした。存在しないチャートでも、戻り値で判定するのが、公式サンプルの形です。
- エラーコードの扱いは記載なし
- 戻り値で判定するのがサンプルの形
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のChartSymbolとChartPeriod、チャートの通貨ペア名を文字列で受け取れる分かりやすさと時間足を列挙型で受け取れる扱いやすさどっちを選ぶ?」
通貨ペア名が欲しいならChartSymbol、時間足が欲しいならChartPeriodです。同じ形の姉妹関数なので、組み合わせて使い、記載のない点は自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










