この記事を開いてくださったこと、心から感謝しています。MQL5のEAで、取引できる時間帯を調べたいと考えた人も多いはずです。
結論から言うと、注文を出せる時間帯を知りたいならSymbolInfoSessionTrade、価格が配信される時間帯まで確かめたいならSymbolInfoSessionQuoteという見方ができます。
ただし、2つの時間帯が実際にどう違うのかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の仕組み・前提・仮の使い方・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
SymbolInfoSessionTradeとSymbolInfoSessionQuoteは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの関数の基本的な性格を整理します。
SymbolInfoSessionTradeは、取引セッションの時刻を返す
MQL5公式リファレンスによると、SymbolInfoSessionTradeは、指定した銘柄と曜日の、取引セッションの開始時刻と終了時刻を受け取る関数です。引数は、銘柄名、曜日、セッションの番号、開始時刻、終了時刻の5つです。
セッションの番号は0から始まります。開始と終了の時刻は、参照渡しで受け取ります。値は、0時0分からの秒数で表され、日付の部分は無視するよう書かれています。データが得られればtrue、得られなければfalseが返ります。
- 銘柄名、曜日、番号を渡す
- 番号は0から始まる
- 時刻の日付部分は無視する
SymbolInfoSessionQuoteは、気配値セッションの時刻を返す
SymbolInfoSessionQuoteは、指定した銘柄と曜日の、気配値のセッションの開始時刻と終了時刻を受け取る関数です。公式ページの書き方では、取引ではなく、気配値(価格の配信)の時間帯を扱う関数と読めます。
引数の並びも、戻り値の意味も、取引側の関数と同じです。違いとして書かれているのは、取引セッションか気配値セッションか、という呼び方だけでした。
- 気配値のセッションを調べる
- 引数は取引側と同じ並び
- 戻り値の意味も同じ
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | SessionTrade | SessionQuote |
|---|---|---|
| 調べる対象 | 取引セッション | 気配値セッション |
| 引数 | 5つで同じ並び | 5つで同じ並び |
| 戻り値 | trueかfalse | trueかfalse |
※公式の説明をもとにした、筆者の整理です。
SymbolInfoSessionTradeで調べると、どうなるのか?
次に、取引セッションを調べる1つ目の方法を見ていきます。
曜日は、列挙型で渡す
曜日は、ENUM_DAY_OF_WEEKという列挙型で渡します。公式のサンプルは、月曜から金曜までを順に調べています。ループの条件は、土曜になる手前までで、土曜と日曜は調べていません。
サンプルでは、失敗したときにGetLastErrorで理由を出力し、成功したときは曜日の名前と時刻を出力します。時刻の整形には、TimeToStringが使われています。
- 曜日はENUM_DAY_OF_WEEKで渡す
- サンプルは月曜から金曜まで
- 失敗したら理由を出力する
公式サンプルでは、GBPUSDの時間帯が出力されている
公式ページのサンプルの出力例は、GBPUSDの取引セッション0で、月曜から金曜まで、いずれも00:15から23:55と書かれています。これはサンプルの出力例であり、すべての口座で同じとは限りません。
| 項目 | サンプルの出力例 |
|---|---|
| 銘柄 | GBPUSD |
| セッション番号 | 0 |
| 時間帯 | 00:15から23:55 |
| 対象の曜日 | 月曜から金曜 |
※公式サンプルの出力例を、筆者が整理しました。
細かい前提は、確認できなかった
祝日の扱いは、確認したページに記載なしでした。夏時間や、時刻がどのタイムゾーンなのかも、記載なしです。1日のセッション数の上限も、記載なしでした。
SymbolInfoSessionQuoteで調べると、どうなるのか?
続いて、気配値のセッションを調べる2つ目の方法を見ていきます。
サンプルの終了時刻は、00:00と表示されている
気配値側のサンプルの出力例は、RU000A103661という銘柄で、気配値セッション0の月曜から金曜が、06:45から00:00と書かれています。終了が00:00と表示されている例です。
この00:00が、翌日の0時を意味するのかどうかは、確認したページに記載なしでした。日をまたぐセッションで、終了が開始より小さくなるのかも、記載なしです。
| 項目 | サンプルの出力例 |
|---|---|
| 銘柄 | RU000A103661 |
| セッション番号 | 0 |
| 時間帯 | 06:45から00:00 |
| 対象の曜日 | 月曜から金曜 |
※公式サンプルの出力例を、筆者が整理しました。
複数のセッションがあるかは、番号から考える
セッションの番号を引数に取るので、1日に複数のセッションがある銘柄を想定した作りだと読めます。ただし、複数あると公式ページが直接述べているわけではありません。
番号を増やしながらfalseが返るまで呼ぶ、という書き方は、サンプルには出てきませんでした。必要な場合は、自分の環境で動きを確かめましょう。
- 番号を引数に取る
- 複数セッションの明記は記載なし
- falseまで繰り返す例は記載なし
テスターでの動きは、確認できなかった
ストラテジーテスターでの動きは、確認したページに記載なしでした。銘柄をマーケットウォッチに出しておく必要があるかも、記載なしです。
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
仮の使い方で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの使い方を比べます。
例の前提を、そろえる
EAが、取引できる時間帯だけ動くようにしたい場合を考えます。1つは、注文を出せる時間帯だけを知りたい場合です。もう1つは、価格が配信されている時間帯も含めて把握したい場合です。
- 注文を出せる時間帯だけ知りたい
- 価格が配信される時間帯も把握したい
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
注文の可否なら、SessionTradeが素直
EAが注文を出す前に、いまが取引セッションの中かを確かめたいなら、SymbolInfoSessionTradeが素直な選択に見えます。曜日と番号を渡し、開始と終了の時刻を受け取って、現在の時刻と比べる流れが考えられます。
このとき、時刻は0時0分からの秒数で返り、日付は無視するよう書かれています。現在の時刻も、同じ形にそろえてから比べる必要があります。
- 曜日と番号を渡す
- 開始と終了を受け取る
- 現在の時刻を同じ形にそろえる
配信の時間帯も見るなら、SessionQuoteを足す
価格が配信される時間帯も把握したいなら、SymbolInfoSessionQuoteも呼んで、2つの時間帯を並べて見る方法が考えられます。2つが同じか違うかは、銘柄や口座によると思われますが、公式ページに記載はありません。
仮の例なので、実際に使う前に、自分の口座の銘柄で両方を出力して、見比べてみてください。
| 流れ(仮) | SessionTrade | SessionQuote |
|---|---|---|
| 注文前の確認 | 向いている | 必要なら併用 |
| 配信時間の把握 | 別に確認 | 向いている |
※仮の前提にもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
注文できる時間を知りたいなら、SessionTradeを選ぶ
注文を出せる時間帯を知りたいなら、SymbolInfoSessionTradeが向いています。銘柄の情報を取る別の関数との違いは、SymbolInfoTickとSymbolInfoDoubleの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
配信の時間帯も見たいなら、SessionQuoteを選ぶ
価格の配信の時間帯まで確かめたいなら、SymbolInfoSessionQuoteが向いています。銘柄の一覧を順に調べる方法は、SymbolsTotalとSymbolNameの記事で整理しています。
- 配信の時間帯を知りたい
- 取引側と見比べたい
- 終了が00:00の扱いに注意
小さく試して、動きを確かめる
いきなり本番のEAに入れず、小さなスクリプトで、月曜から金曜までの時間帯を出力してみましょう。取引側と気配値側を両方出して、見比べておくと安心です。









もう1つのコツは、時間帯を調べる処理を、1か所の関数にまとめておくことです。取り方を変えたくなったときも、その関数だけを直せば済むので、見直しやすくなります。
また、取得した時間帯は、毎回調べ直さず、日が変わったときだけ更新する形も考えられます。ただし、更新の頻度が適切かどうかは、公式ページに記載がないため、自分の環境で確かめてください。
さらに、時間帯をログに出力しておくと、あとで見返したときに、どの曜日のどの番号の時間帯を使ったのかが分かります。トラブルがあったときの手がかりにもなり、安心して調べ直せます。
反対に、時刻の整形は、TimeToStringに任せると、見やすい形で出力できます。公式のサンプルも、この方法で時分だけを出力しており、真似しやすい書き方です。
- 時間帯を調べる処理を1つの関数にまとめる
- 取得した時間帯をログに出す
- 時刻の整形はTimeToStringに任せる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
SYMBOL_SESSION_で始まる定数とは、同じものなのか?
いいえ。公式の定数のページにあるSYMBOL_SESSION_DEALSやSYMBOL_SESSION_OPENなどは、現在のセッションの約定の数や始値といった、統計の値です。時間帯の境目を表す定数ではありません。
- SYMBOL_SESSION_DEALSは約定の数
- SYMBOL_SESSION_OPENは始値
- 時間帯の境目ではない
SYMBOL_TRADE_MODEとは、何が違うのか?
SYMBOL_TRADE_MODEは、銘柄の取引の制限を表す値です。取引の無効、買いのみ、売りのみ、決済のみ、制限なしが、定数として載っています。時間帯ではなく、取引の種類の制限を表すものです。
- 取引の無効や制限なしなどがある
- 時間帯ではなく取引の種類の制限
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のSymbolInfoSessionTradeとSymbolInfoSessionQuote、売買できる時間帯を調べる確かさと値動きが配信される時間帯を調べる丁寧さどっちを選ぶ?」
注文の時間帯ならSymbolInfoSessionTrade、配信の時間帯まで見るならSymbolInfoSessionQuoteが向いています。記載のない点は、自分の環境で確かめましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










