この記事を開いてくださったこと、心から感謝しています。プログラムの中で、今の時刻を使いたいと考えている人も、きっと多いはずです。
結論から言うと、取引サーバーの時刻に合わせたいならTimeCurrent、パソコンの手元の時刻を読みたいならTimeLocalです。どちらも今の時刻を返しますが、基準になる時計が違います。
また、サーバーの時差の値など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の役割・引数・時刻の基準・テスターでの動き・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
TimeCurrentとTimeLocalは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つはサーバーの時刻を返す関数で、もう1つはパソコンの時刻を返す関数です。
TimeCurrentは、最後に受け取った気配値の時刻を返す
TimeCurrentは、取引サーバーで作られた時刻を返す関数です。公式の説明では、パソコンの時刻設定には依存しない、と書かれています。
この時刻は、最後に知られているサーバー時刻、つまり、マーケットウォッチの銘柄の気配値を最後に受け取った時刻です。戻り値は、datetime型です。
- 取引サーバーで作られた時刻を返す
- パソコンの時刻設定には、依存しない
- 最後に気配値を受け取った時刻にあたる
TimeLocalは、パソコンの時刻を返す
TimeLocalは、クライアントターミナルが動いているパソコンの、ローカル時刻を返す関数です。パソコンの時計が基準なので、パソコンの設定が変わると、値も変わります。
夏時間の扱いや、時差の表し方は、確認したページには、記載なしでした。戻り値は、TimeCurrentと同じく、datetime型です。
- パソコンのローカル時刻を返す
- 基準は、パソコンの時計
- 夏時間の扱いは、記載なし
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | TimeCurrent | TimeLocal |
|---|---|---|
| 基準の時計 | 取引サーバー | パソコン |
| 戻り値 | datetime | datetime |
| 引数の書き方 | なし、または構造体の参照 | なし、または構造体の参照 |
| テスターでの動き | 過去データから模擬される | TimeCurrentの模擬時刻と同じ |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
TimeCurrentは、どんな場面で使うのか?
TimeCurrentは、取引の時間帯や、足の時刻に合わせた処理を作りたいときに使います。公式の説明から、動き方を確認します。
呼ぶ場所によって、意味が少し変わる
OnTickの中で呼ぶと、処理しているティックの時刻になります。OnInitやOnTimerなどで呼ぶと、マーケットウォッチにある銘柄の、最後の気配値の時刻です。
2つのイベントの違いは、OnTickとOnTimerの記事で整理しています。呼ぶ場所と時刻の意味を、あわせて確認すると分かりやすくなります。
- OnTickの中は、処理中のティックの時刻
- それ以外は、最後の気配値の時刻
- 複数銘柄のときの選び方は、記載なし
構造体へ分けて受け取れる
TimeCurrentには、引数なしの書き方と、MqlDateTime型の変数を渡す書き方があります。後者では、年・月・日・時・分・秒などが、変数へ分けて入ります。
曜日や時間だけを調べたいときは、構造体で受け取ると便利です。公式サンプルは、datetime型の値と、構造体の値の両方を、並べて表示しています。
- 引数なしなら、datetime型の値だけ返る
- 構造体を渡すと、年月日などが分かれて入る
- 曜日や時間を調べるときに便利
サーバーの時差は、記載がない
TimeCurrentが返すのは、サーバー時刻ですが、サーバーが世界標準時から何時間ずれているかは、確認したページには、記載なしでした。
時差を知りたいときは、別の関数のページを、確かめる必要があります。この記事では、それらのページは確認していないため、触れません。
- サーバーの時差は、記載なし
- 別のページを、確かめる必要がある
- この記事では、確認していない
市場が止まっているときの動きも、記載がない
公式の説明では、最後に気配値を受け取った時刻とされているだけで、休場や週末の動きは、書かれていません。まだ気配値がないときの値も、記載なしです。
最後の時刻のまま動かない可能性は、言葉の使い方から考えられます。ただし、これは筆者の推測で、公式の説明ではありません。
- 休場や週末の動きは、記載なし
- 気配値がないときの値は、記載なし
- 動かない可能性は、筆者の推測
TimeLocalは、どんな場面で使うのか?
TimeLocalは、パソコンの手元の時刻を、そのまま使いたいときに使います。ログに残す時刻や、画面へ出す時刻などで便利です。
パソコンの時計が基準になる
TimeLocalは、パソコンのローカル時刻を返します。サーバーの時刻とは別の時計なので、2つの値には、ずれがあるのが普通です。
公式サンプルには、2つの時刻が並んで載っていますが、その差は、サンプルの一例です。公式が決めた時差ではありません。
- パソコンの時計が、基準になる
- サーバー時刻とは、ずれがあるのが普通
- サンプルの差は、一例にすぎない
ストラテジーテスターでは、TimeCurrentと同じになる
公式の説明では、テスターの中では、TimeLocalは、常に、模擬されたサーバー時刻であるTimeCurrentと等しくなります。パソコンの時計は、使われません。
そのため、検証中は、パソコンの時刻に頼った処理が、本番とは違う動きになる可能性があります。これは、公式の説明をもとにした、筆者の考えです。
- テスターでは、TimeCurrentと等しくなる
- パソコンの時計は、使われない
- 本番との違いに、注意が必要
構造体で受け取る書き方も、同じ
TimeLocalにも、引数なしの書き方と、MqlDateTime型の変数を渡す書き方があります。使い方は、TimeCurrentと同じ形で、迷いにくい作りです。
- 引数なしと、構造体を渡す書き方がある
- TimeCurrentと、同じ形
- 年月日などが、分かれて入る
公式のサンプルは、どう書かれているのか?
2つの関数には、それぞれ公式サンプルがあります。形はほとんど同じで、2通りの書き方を並べて表示する内容です。
TimeCurrentのサンプルは、ティックの時刻を表示する
TimeCurrentのサンプルは、MqlDateTime型の変数を用意します。そして、引数なしの値と、構造体を渡した値を、それぞれ取得します。
そのあと、PrintFormatで、年・月・日・時・分・秒と、曜日などを表示します。ページには、2024年の日時と、木曜日の出力例が載っています。
- 構造体を用意して、2通りで取得する
- PrintFormatで、年月日などを表示する
- 出力例は、2024年の日時
TimeLocalのサンプルは、ローカル時刻を表示する
TimeLocalのサンプルも、同じ流れです。引数なしの値と、構造体の値を取得して、年月日などを表示します。出力例は、ローカル時刻として載っています。
| サンプル | 主な流れ |
|---|---|
| TimeCurrent | 2通りで取得して、サーバー時刻を表示する |
| TimeLocal | 2通りで取得して、ローカル時刻を表示する |
※公式サンプルの内容を、筆者が整理しました。
サンプルを読むときの注意点
2つの出力例は、2024年の、ある日の時刻です。今の時刻や、ずれの大きさを示すものではありません。
この記事の説明は、プログラムの動きの紹介で、運用の助言ではありません。自分の環境で、小さく試して、値を確かめましょう。
- 出力例は、ある日の例にすぎない
- ずれの大きさは、環境で変わる
- 自分の環境で、試して確かめる
どう使い分ければよいのか?
2つは競合する関数ではなく、基準になる時計が違います。サーバーに合わせるのか、パソコンに合わせるのかで、使い分けます。
サーバーに合わせたいなら、TimeCurrentを選ぶ
足の時刻や、取引の時間帯に合わせたいときは、TimeCurrentが向いています。パソコンの設定に左右されないのが、特長です。
取引できる時間帯を調べる関数は、SymbolInfoSessionTradeの記事が参考になります。時刻の基準を揃える考え方が、分かりやすくなります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
手元の時刻を使いたいなら、TimeLocalを選ぶ
ログに残す時刻や、画面へ出す時刻など、パソコンの手元の時刻で足りるときは、TimeLocalが向いています。
- ログへ、手元の時刻を残したい
- 画面へ、ローカル時刻を出したい
- サーバーとの比較は、必要ない
どちらも、高い精度が必要なときには向かない
公式のページには、ミリ秒単位の精度が必要なら、GetTickCountを使うよう、案内があります。2つの関数は、その用途には向きません。
- ミリ秒の精度は、GetTickCountを使う
- 2つの関数は、その用途に向かない
- 精度の数値は、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。小さな部品から、順に確かめるのが安心です。
まずは、2つの値を並べて表示する
最初に、スクリプトで、2つの時刻を、ログへ並べて出します。サーバー時刻とローカル時刻に、ずれがあることを、自分の目で確かめます。
- 2つの値を、ログへ並べる
- ずれがあることを、確かめる
- 構造体でも、取得してみる
次に、使う場面を決める
サーバーに合わせるのか、手元の時刻でよいのかを、処理ごとに決めます。迷ったら、足の時刻に関わる処理は、TimeCurrentで考えるのが安心です。
- 処理ごとに、基準を決める
- 足の時刻は、TimeCurrentで考える
- ログは、TimeLocalで足りる
最後に、テスターでの動きを確かめる
テスターでは、TimeLocalも、模擬されたサーバー時刻になります。検証と本番で、値の意味が変わらないかを、先に確かめておきましょう。









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










