この記事を開いてくださったこと、心から感謝しています。プログラムの中で、世界標準時やサーバーの時刻を使いたいと考えている人も、きっと多いはずです。
結論から言うと、世界標準時(GMT)が欲しいならTimeGMT、サーバーの現在時刻を手元で計算して出したいならTimeTradeServerです。どちらもパソコンの時計をもとに計算する点が、共通しています。
また、サーバーの時差やエラーコードなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・計算の仕組み・テスターでの動き・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
TimeGMTとTimeTradeServerは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つは世界標準時を返す関数で、もう1つはサーバーの現在時刻を返す関数です。
TimeGMTは、パソコンの時刻から世界標準時を計算する
TimeGMTは、クライアントターミナルが動いているパソコンのローカル時刻から、夏時間の切り替えも考えて、GMT(世界標準時)を計算して返す関数です。戻り値は、datetime型です。
基準になるのはパソコンの時計です。そのため、パソコンの時刻や時間帯の設定が変わると、結果にも影響する可能性があります。
- パソコンのローカル時刻から計算する
- 夏時間の切り替えも、考えて計算する
- 戻り値は、datetime型
TimeTradeServerは、サーバーの現在時刻を計算して返す
TimeTradeServerは、取引サーバーの現在時刻を、計算で求めて返す関数です。公式の説明では、TimeCurrentとは違い、クライアントターミナルの中で計算され、パソコンの時刻設定に左右されると書かれています。
TimeCurrentとの違いは、TimeCurrentとTimeLocalの記事で整理しています。サーバー時刻の基準を、あわせて確認すると分かりやすくなります。
- サーバーの現在時刻を、計算で求める
- ターミナルの中で計算される
- パソコンの時刻設定に、左右される
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | TimeGMT | TimeTradeServer |
|---|---|---|
| 返す時刻 | 世界標準時(GMT) | 取引サーバーの現在時刻 |
| 計算の元 | パソコンのローカル時刻 | ターミナル内の計算 |
| 戻り値 | datetime | datetime |
| 引数の書き方 | なし、または構造体の参照 | なし、または構造体の参照 |
| テスターでの動き | 模擬されたサーバー時刻と同じ | TimeCurrentと常に同じ |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
TimeGMTは、どんな場面で使うのか?
TimeGMTは、パソコンの場所に関係なく、世界共通の基準で時刻を扱いたいときに使います。公式の説明から、動き方を確認します。
構造体へ分けて受け取れる
TimeGMTには、引数なしの書き方と、MqlDateTime型の変数を渡す書き方があります。後者では、年・月・日・時・分・秒などが、変数へ分けて入ります。
曜日や時間だけを調べたいときは、構造体で受け取ると便利です。公式サンプルは、構造体の各項目と曜日の名前を、ログへ並べて表示しています。
- 引数なしなら、datetime型の値だけ返る
- 構造体を渡すと、年月日などが分かれて入る
- 曜日や時間を調べるときに便利
ローカル時刻との差から、時差が見える
公式サンプルは、TimeLocalとTimeGMTの値を並べて、その差を時間で表示しています。差を見ると、パソコンが世界標準時から何時間ずれているかが分かります。
サンプルの出力例は、ローカル時刻が19時台、GMTが12時台で、差は7時間でした。これは、2024年のある日の、サンプルの一例にすぎません。
- TimeLocalとTimeGMTの差が、時差になる
- サンプルの差は、7時間だった
- あくまで、ある日の一例
符号の向きに、注意が必要
サンプルでは、ローカル時刻からGMTを引いて、プラス7と表示しています。一方、TimeGMTOffsetは、GMTからローカル時刻を引くと説明されており、同じ状況でマイナスの値になります。
同じ時差でも、引く順番によって、プラスにもマイナスにもなります。自分のコードでは、どちらの向きで計算するかを、決めておくと安心です。
- サンプルは、ローカル時刻からGMTを引く
- TimeGMTOffsetは、GMTからローカル時刻を引く
- 引く順番で、符号が逆になる
TimeTradeServerは、どんな場面で使うのか?
TimeTradeServerは、サーバーの現在時刻に近い値を、いつでも手元で求めたいときに使います。仕組みの特徴を、公式の説明から確認します。
パソコンの設定に、左右される
公式の説明では、TimeTradeServerは、クライアントターミナルの中で計算され、パソコンの時刻設定に左右されます。気配値を最後に受け取った時刻を返すTimeCurrentとは、そこが違います。
公式サンプルでは、両者の差を秒で表示しています。出力例では、差は1秒で、TimeTradeServerのほうが少し進んでいました。これも、ある日の一例です。
- ターミナルの中で、計算される
- パソコンの時刻設定に、左右される
- サンプルの差は、1秒だった
ストラテジーテスターでは、TimeCurrentと同じになる
公式の説明では、テスターの中では、TimeTradeServerは、過去データから模擬され、常にTimeCurrentと等しくなります。パソコンの時計に左右される点は、ここでは当てはまりません。
検証と本番で、値の決まり方が違う可能性があります。これは、公式の説明をもとにした、筆者の考えです。
- テスターでは、過去データから模擬される
- 常に、TimeCurrentと等しくなる
- 本番との違いに、注意が必要
サーバーの時差は、記載がない
TimeTradeServerが返すのは、サーバーの現在時刻ですが、サーバーが世界標準時から何時間ずれているかは、確認したページには、記載なしでした。
休場や週末のときの値や、計算の精度についても、記載なしです。値を使う前に、自分の環境で、ログへ出して確かめましょう。
- サーバーの時差は、記載なし
- 休場や週末の動きは、記載なし
- 精度は、記載なし
TimeGMTOffsetとは、何なのか?
2つの関数のページには、関連する関数として、TimeGMTOffsetが紹介されています。ここで、その役割も確認しておきます。
GMTとパソコンの時刻の差を、秒で返す
TimeGMTOffsetは、引数がなく、int型の値を返す関数です。公式の説明では、現在のGMTとパソコンのローカル時刻との差を、秒で返します。
夏時間や冬時間の切り替えも、考えられた値で、パソコンの時刻設定に左右されます。公式サンプルでは、マイナス25200秒と表示されています。
- 引数なしで、int型を返す
- GMTとローカル時刻の差を、秒で返す
- サンプルでは、マイナス25200秒
テスターでの動きは、記載がない
TimeGMTOffsetのページには、テスターでの動きに関する説明が、見当たりませんでした。値がどうなるかは、記載なしです。
- テスターでの値は、記載なし
- エラーコードも、記載なし
- 自分の環境で、確かめる
どう使い分ければよいのか?
2つは、似た名前ですが、返す時刻の種類が違います。世界標準時が欲しいのか、サーバー時刻が欲しいのかで、使い分けます。
世界標準時が欲しいなら、TimeGMTを選ぶ
パソコンの場所に関係なく、世界共通の基準で時刻を扱いたいときは、TimeGMTが向いています。ただし、元になるのはパソコンの時計なので、時計の設定には気をつけましょう。
FX口座・ツールの比較一覧もあわせて確認してみてください。
サーバーの時刻に近い値が欲しいなら、TimeTradeServerを選ぶ
気配値を待たずに、サーバーの現在時刻に近い値が欲しいときは、TimeTradeServerが向いています。ただし、計算された値なので、TimeCurrentと少しずれることがあります。
取引できる時間帯を調べる関数は、SymbolInfoSessionTradeの記事が参考になります。時刻の基準を揃える考え方が、分かりやすくなります。
- 現在時刻に近い値を、いつでも求めたい
- 気配値を、待ちたくない
- TimeCurrentとのずれは、許せる
どちらも、高い精度が必要なときには向かない
公式のページには、ミリ秒単位の精度が必要なら、GetTickCountを使うよう、案内があります。2つの関数は、その用途には向きません。
- ミリ秒の精度は、GetTickCountを使う
- 2つの関数は、その用途に向かない
- 精度の数値は、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。小さな部品から、順に確かめるのが安心です。
まずは、複数の時刻を並べて表示する
最初に、スクリプトで、TimeLocal、TimeGMT、TimeCurrent、TimeTradeServerを、ログへ並べて出します。それぞれの値の関係を、自分の目で確かめます。
- 4つの時刻を、ログへ並べる
- 差を、秒で計算してみる
- 符号の向きを、決めておく
次に、使う場面を決める
世界標準時が欲しいのか、サーバー時刻が欲しいのかを、処理ごとに決めます。迷ったら、足の時刻に関わる処理は、TimeCurrentで考えるのが安心です。
- 処理ごとに、基準を決める
- 世界標準時は、TimeGMTで考える
- サーバー時刻は、TimeTradeServerで考える
最後に、テスターでの動きを確かめる
テスターでは、TimeGMTもTimeTradeServerも、模擬されたサーバー時刻になります。検証と本番で、値の意味が変わらないかを、先に確かめておきましょう。









もう1つのコツは、時刻の取り方を、1か所の関数にまとめておくことです。基準を変えたくなったときも、直す場所が少なくて済みます。
- 時刻の取り方を、1か所にまとめる
- 結果は、まずログに出して確かめる
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
TimeGMTは、サーバーから時刻を受け取るのか?
いいえ、公式の説明では、TimeGMTは、パソコンのローカル時刻から、夏時間の切り替えを考えて、GMTを計算して返します。
- 元になるのは、パソコンのローカル時刻
- 夏時間の切り替えも、考える
TimeTradeServerとTimeCurrentは、同じ値なのか?
テスターの中では、常に等しくなります。ふだんは、TimeTradeServerが計算された値で、TimeCurrentとは、少しずれることがあると、公式サンプルから読み取れます。
- テスターでは、常に等しい
- ふだんは、少しずれることがある
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のTimeGMTとTimeTradeServer、世界標準時を手元から割り出せる便利さと取引サーバーの時刻を計算で出せる手軽さどっちを選ぶ?」
世界標準時ならTimeGMT、サーバーの現在時刻を計算で出すならTimeTradeServerです。どちらもパソコンの時計が元になる点を知り、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










