MQL5 TimeCurrentの使い方｜サーバー時間・EA稼働時間判定の確認

MQL5でEAの稼働時間、停止時間、曜日判定、外部連携、ログ出力を作る時は、現在時刻の扱いを明確にしておく必要があります。

TimeCurrentは、MQL5でサーバー時間を確認する時によく使う関数です。ただし、TimeCurrentは単純なPC現在時刻ではなく、最後に受信した気配値のサーバー時刻を返す関数です。

EAが指定時間に動かない、バックテストとリアル環境で時刻判定が違う、OnTimerで時刻が更新されないように見える、サーバー時間と日本時間を混同する、といった問題は、TimeCurrent、TimeTradeServer、TimeLocal、TimeToStructの役割を分けて確認すると原因を追いやすくなります。

このページでは、MQL5のTimeCurrentの使い方を、サーバー時間、OnTick / OnTimerでの違い、EA稼働時間判定、TimeToStruct、StructToTime、ログ確認の観点から整理します。

なお、このページはMQL5開発における技術確認を目的とした内容です。売買判断、推奨エントリー、推奨ロット、利益保証、損失回避保証を行うものではありません。

TimeCurrentとは何か

TimeCurrentは、MQL5で最後に確認できているサーバー時間をdatetime型で返す関数です。

OnTick内で呼ぶ場合は、処理中のtickの時刻として扱えます。一方、OnInit、OnTimer、OnDeinitなどで呼ぶ場合は、Market Watch内で最後に受信した気配値の時刻として扱われます。

void OnTick()
{
   datetime now = TimeCurrent();

   PrintFormat("[TIME_CURRENT] now=%s",
               TimeToString(now, TIME_DATE|TIME_SECONDS));
}

TimeCurrentは、EAの時間判定でよく使いますが、「PCの現在時刻」ではありません。サーバー時間を基準にEAを動かす時に使う関数として理解してください。

TimeCurrentで確認できること

TimeCurrentは、EAの実務では、稼働時間、停止時間、曜日、日付、ログ時刻、外部連携の更新間隔などで使います。

EAの時間判定では、どの時間を基準にしているのかを明確にしてください。サーバー時間、日本時間、PCローカル時間を混同すると、稼働時間や停止時間の判定がずれる場合があります。

TimeCurrentとTimeTradeServerの違い

TimeCurrentとTimeTradeServerは、どちらも取引サーバー時刻に関係しますが、取得の考え方が異なります。

EAの売買判定や稼働時間判定では、原則としてサーバー時間を基準にする方が確認しやすくなります。PCローカル時間を使う場合は、VPSやPC環境差を考慮してください。

OnTickとOnTimerでのTimeCurrentの違い

TimeCurrentは、呼び出すイベントによって確認の意味が変わります。

OnTick内では、そのtickを処理している時刻として扱いやすい一方、OnTimerでは必ずしも毎秒更新され続ける時刻ではありません。最後にMarket Watchで受信した気配値の時刻として見る必要があります。

OnTimerで「現在時刻が進まない」と見える場合は、TimeCurrentの仕様と、対象銘柄やMarket Watchのtick受信状態を確認してください。

TimeToStructで時分・曜日を取り出す

EAの稼働時間や曜日判定では、TimeCurrentで取得したdatetimeをMqlDateTimeへ変換すると扱いやすくなります。

bool GetServerTimeStruct(MqlDateTime &t)
{
   datetime now = TimeCurrent();

   if(!TimeToStruct(now, t))
   {
      PrintFormat("[TIME_TO_STRUCT_NG] now=%s",
                  TimeToString(now, TIME_DATE|TIME_SECONDS));
      return false;
   }

   PrintFormat("[SERVER_TIME_STRUCT] year=%d mon=%d day=%d hour=%d min=%d sec=%d day_of_week=%d",
               t.year,
               t.mon,
               t.day,
               t.hour,
               t.min,
               t.sec,
               t.day_of_week);

   return true;
}

MqlDateTimeでは、hour、min、sec、day_of_weekなどを使って、稼働時間や曜日条件を判定できます。

EA稼働時間を判定する基本

EAの稼働時間を判定する場合は、TimeCurrentをTimeToStructで分解し、現在時刻を分単位に変換すると確認しやすくなります。

bool IsWithinServerTimeRange(const int start_hour,
                             const int start_min,
                             const int end_hour,
                             const int end_min)
{
   MqlDateTime t;

   if(!TimeToStruct(TimeCurrent(), t))
      return false;

   int now_min   = t.hour * 60 + t.min;
   int start_min_total = start_hour * 60 + start_min;
   int end_min_total   = end_hour * 60 + end_min;

   bool allowed = false;

   if(start_min_total <= end_min_total)
   {
      allowed = (start_min_total <= now_min && now_min <= end_min_total);
   }
   else
   {
      allowed = (now_min >= start_min_total || now_min <= end_min_total);
   }

   PrintFormat("[TIME_GATE] server_time=%02d:%02d start=%02d:%02d end=%02d:%02d allowed=%s",
               t.hour,
               t.min,
               start_hour,
               start_min,
               end_hour,
               end_min,
               (allowed ? "true" : "false"));

   return allowed;
}

日またぎの稼働時間を扱う場合は、開始時刻が終了時刻より後になるケースを考慮してください。例えば、22:00〜02:00のような設定では、同じ日の範囲判定だけでは正しく判定できません。

曜日判定の基本

MqlDateTimeのday_of_weekを使うと、曜日を確認できます。

EAの曜日停止、金曜停止、月曜開始制限などを作る時は、曜日番号をログへ出すと確認しやすくなります。

bool IsAllowedDay()
{
   MqlDateTime t;

   if(!TimeToStruct(TimeCurrent(), t))
      return false;

   bool allowed = true;

   if(t.day_of_week == 0)
      allowed = false;

   if(t.day_of_week == 6)
      allowed = false;

   PrintFormat("[DAY_GATE] day_of_week=%d allowed=%s",
               t.day_of_week,
               (allowed ? "true" : "false"));

   return allowed;
}

曜日判定は、サーバー時間基準で行われます。日本時間の曜日で判定したい場合は、時差変換の仕様を別途決める必要があります。

日本時間に変換する時の注意点

EA利用者向けには「日本時間で何時から何時まで」と説明したくなる場合があります。

ただし、EA内部のTimeCurrentはサーバー時間です。サーバー時間と日本時間の差は、ブローカー、サーバー設定、夏時間、時期によって変わる場合があります。

配布用EAでは、入力欄がサーバー時間基準なのか、日本時間基準なのかを明記してください。ログにもserver_timeと基準を出しておくと、問い合わせ時に確認しやすくなります。

TimeCurrentをログへ出す

EAの時間判定を確認するには、TimeCurrentをログへ出すことが重要です。

時刻だけでなく、判定結果、稼働開始時刻、稼働終了時刻、曜日、時間基準をセットで出すと原因を追いやすくなります。

void PrintTimeGateLog(const bool allowed,
                      const string reason)
{
   datetime server_time = TimeCurrent();
   datetime trade_time  = TimeTradeServer();
   datetime local_time  = TimeLocal();

   PrintFormat("[TIME_GATE_LOG] server_time=%s trade_server_time=%s local_time=%s allowed=%s reason=%s",
               TimeToString(server_time, TIME_DATE|TIME_SECONDS),
               TimeToString(trade_time, TIME_DATE|TIME_SECONDS),
               TimeToString(local_time, TIME_DATE|TIME_SECONDS),
               (allowed ? "true" : "false"),
               reason);
}

server_time、trade_server_time、local_timeを一度に出すと、時刻基準の混同を見つけやすくなります。ただし、通常運用で毎tick出すとログが多くなるため、状態変化時や一定間隔に抑えてください。

SymbolInfoSessionTradeと取引セッション

銘柄ごとの取引時間を確認したい場合は、SymbolInfoSessionTradeを使って取引セッションの開始・終了時刻を確認できます。

EAの稼働時間設定と、銘柄自体の取引可能時間は別です。EA側の時間設定では許可されていても、銘柄の取引セッション外であれば注文できない場合があります。

void PrintTradeSession(const string symbol)
{
   MqlDateTime t;
   TimeToStruct(TimeCurrent(), t);

   datetime from = 0;
   datetime to   = 0;

   if(!SymbolInfoSessionTrade(symbol, (ENUM_DAY_OF_WEEK)t.day_of_week, 0, from, to))
   {
      PrintFormat("[SESSION_TRADE_NG] symbol=%s day=%d last_error=%d",
                  symbol,
                  t.day_of_week,
                  GetLastError());
      return;
   }

   PrintFormat("[SESSION_TRADE] symbol=%s day=%d from=%s to=%s",
               symbol,
               t.day_of_week,
               TimeToString(from, TIME_MINUTES),
               TimeToString(to, TIME_MINUTES));
}

取引時間外の注文エラーを調査する場合は、EAの稼働時間設定だけでなく、銘柄の取引セッション、サーバー時間、Journalログを合わせて確認してください。

外部連携や通知で使う時の注意点

TimeCurrentは、WebRequest、Discord通知、Google Sheets連携、CSV出力などでも使います。

外部連携では、いつ取得した情報なのか、いつ送信した情報なのかをログへ残す必要があります。

外部シートや通知先では、日本時間で見たい場合があります。その場合でも、EA内部の判定基準がサーバー時間なのか、変換後時刻なのかを分けてください。

バックテストでの確認ポイント

Strategy TesterでTimeCurrentを使う場合は、テスト中のサーバー時刻として確認します。

リアル環境とはtickの入り方、OnTimerの呼ばれ方、外部連携ON/OFF、ログ量が異なる場合があります。時間判定を検証する時は、テスター用のログを用意すると確認しやすくなります。

バックテストでは、時間判定ログを出しすぎると検証が重くなります。NG時、状態変化時、または一定間隔だけに絞ると確認しやすくなります。

よくある失敗パターン

ログ出力例

[TIME_INIT] server_time=2026.05.26 10:15:00 local_time=2026.05.26 16:15:00 basis=SERVER
[TIME_GATE] server_time=10:15 start=09:00 end=23:00 allowed=true
[DAY_GATE] day_of_week=2 allowed=true
[SESSION_TRADE] symbol=GOLD day=2 from=01:05 to=23:55
[TIME_GATE_LOG] server_time=2026.05.26 10:15:00 trade_server_time=2026.05.26 10:15:01 local_time=2026.05.26 16:15:01 allowed=true reason=within_server_time_range
[LOG_THROTTLE] category=TIME_GATE interval_sec=300 reason=skip_duplicate_state

ログ例の時刻や時差は確認用です。実際のサーバー時間、ローカル時間、取引セッションは、口座環境、ブローカー、銘柄、VPS設定によって変わります。

TimeCurrentとあわせて確認したいバー時刻・価格取得

TimeCurrentでサーバー時間やEA稼働時間を確認する場合は、バー時刻や価格取得のタイミングも分けて確認します。現在時刻、バー時刻、確定足の値を混同しないように整理してください。

関連ページ

TimeCurrentは、EA稼働時間、外部連携、ログ確認、時系列データ、バックテスト確認と合わせて整理すると理解しやすくなります。

時刻データとEA稼働時間をあわせて確認する場合

TimeCurrentは、MQL5でサーバー時間を確認する時によく使う関数です。EAの稼働時間、曜日判定、日付切り替え、ログ時刻、外部連携の更新間隔を整理する場合は、時系列データ全体やEA稼働時間の基本もあわせて確認してください。

時間判定を確認する時は、TimeCurrent、TimeTradeServer、TimeLocalを混同しないようにしてください。ログでは、server_time、local_time、判定時間、曜日、allowed判定を分けて出すと原因を追いやすくなります。

開発依頼前に整理したい情報

TimeCurrentやEA稼働時間判定、サーバー時間のずれを相談する場合は、次の情報を整理してください。

時間判定の不具合を相談する場合は、設定値だけでなく、EAが実際に出したserver_time、local_time、判定結果ログを合わせて確認してください。

MT4/MT5の開発・改修相談はこちら

まとめ

TimeCurrentは、MQL5で最後に受信した気配値のサーバー時刻を確認するための関数です。

OnTick内では処理中tickの時刻として扱いやすい一方、OnTimerやOnInitでは最後に受信した気配値時刻として見る必要があります。

EAの稼働時間、停止時間、曜日判定、日付切り替え、外部連携、ログ出力では、TimeCurrent、TimeTradeServer、TimeLocalを混同しないことが重要です。

時間判定を実装する場合は、サーバー時間基準なのか、日本時間基準なのかを明確にし、TimeToStruct、day_of_week、日またぎ判定、SymbolInfoSessionTrade、ログ確認をセットで整理してください。