MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のChartSymbolとChartPeriod、チャートの通貨ペア名を文字列で受け取れる分かりやすさと時間足を列挙型で受け取れる扱いやすさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のChartSymbolとChartPeriod、チャートの通貨ペア名を文字列で受け取れる分かりやすさと時間足を列挙型で受け取れる扱いやすさどっちを選ぶ?

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

この記事を開いてくださったこと、心から感謝しています。チャートの通貨ペアや時間足を、プログラムから調べたいと考えている人も多いはずです。

結論から言うと、通貨ペアの名前が欲しいならChartSymbol、時間足が欲しいならChartPeriodです。どちらもチャートIDを渡して使い、存在しないチャートを渡したときの戻り値も公式に書かれています。

ただし、エラーコードの扱いや、カスタム銘柄での動きなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。

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

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

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で存在を判定したい
  • 名前に直して表示したい

小さく試して、動きを確かめる

いきなり複雑な処理を作らず、公式サンプルのように、現在のチャートの通貨ペアと時間足を表示するところから始めましょう。

2つが同じ形の姉妹関数だと分かって、全体像が整理できました。調べてよかったです。
存在しないときの戻り値が分かって、使う前の確認ができて安心しました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
2つを見比べたら、場面ごとの選び方が整理されて、コードを書くのが楽しみになりました。

もう1つのコツは、渡すチャートIDを、変数に入れて名前を付けておくことです。どのチャートの値なのかが、あとから読み返しても分かりやすくなります。

  • チャートIDは、変数に入れて使う
  • 結果は、まずログに出して確かめる
  • 存在判定の結果を、必ず確認する

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

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

引数なしで呼ぶと、どのチャートが対象なのか?

チャートIDの初期値は0で、0は現在のチャートを意味します。そのため、引数なしでは現在のチャートが対象です。

  • 引数なしは、現在のチャート
  • 0を明示しても、同じ意味

エラーコードは、どうなるのか?

2つのページには、エラーコードやGetLastErrorの扱いは、記載なしでした。存在しないチャートでも、戻り値で判定するのが、公式サンプルの形です。

  • エラーコードの扱いは記載なし
  • 戻り値で判定するのがサンプルの形

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

いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。

  • 仮の前提による例
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のChartSymbolとChartPeriod、チャートの通貨ペア名を文字列で受け取れる分かりやすさと時間足を列挙型で受け取れる扱いやすさどっちを選ぶ?」

通貨ペア名が欲しいならChartSymbol、時間足が欲しいならChartPeriodです。同じ形の姉妹関数なので、組み合わせて使い、記載のない点は自分の環境で確かめましょう。

  • 通貨ペア名ならChartSymbol
  • 時間足ならChartPeriod
  • 記載なしの点は自分で確かめる

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

出典・参照元

  • MQL5 リファレンス(ChartSymbol)
  • MQL5 リファレンス(ChartPeriod)

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

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のChartFirstとChartNext、最初のチャートのIDをすぐ受け取れる手軽さと次のチャートを順にたどれる便利さどっちを選ぶ?
  • MQL5のChartGetIntegerとChartGetDouble、幅や表示本数などを整数で読み取れる幅広さと価格の上下限を小数で読み取れる細かさどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

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

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

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

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

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • 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日
検索
人気記事
  • 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と人工知能の力.

目次