【MQL5】TimeToStruct関数の使い方と自動売買実装コード

1. TimeToStruct関数の概要と実務での活用法

MQL5におけるTimeToStructは、datetime型（1970年1月1日から経過した「秒数」）のデータを、人間が理解しやすい「年・月・日・時・分・秒」に分解し、MqlDateTime構造体に格納するための関数です。

実務レベルの開発において、この関数は「特定の時間帯だけ取引する」「金曜日の夜にポジションを全決済する」「月が変わったタイミングで月次統計をリセットする」といった、時間条件に基づくロジックの実装に不可欠です。

初心者がよく陥る罠として、TimeCurrent()で取得した秒数をそのまま計算（例：if(TimeCurrent() % 86400 == 0)など）して時間を判定しようとすることがありますが、これはコードの可読性を著しく下げ、バグの原因になります。TimeToStructを使うことで、「今の曜日は？」「今の時間は？」といった問いに対して、直感的かつ確実な条件分岐を記述できるようになります。

2. 構文と戻り値

TimeToStruct関数の構文は以下の通りです。

bool TimeToStruct(
   datetime      dt,            // 変換する日時（秒数）
   MqlDateTime&  dt_struct      // データを格納する構造体変数
);

パラメーター

• dt: 変換したいdatetime型の値を指定します。通常はTimeCurrent()（サーバー時間）やTimeLocal()（ローカル時間）を渡します。
• dt_struct: MqlDateTime型の構造体変数を「参照渡し」します。この変数の中に分解された日時データが書き込まれます。

戻り値

• 成功した場合は true、失敗した場合は false を返します。

MqlDateTime構造体の構成

この関数を呼び出すと、以下の要素にアクセスできるようになります。
– year: 年
– mon: 月 (1-12)
– day: 日 (1-31)
– hour: 時 (0-23)
– min: 分 (0-59)
– sec: 秒 (0-59)
– day_of_week: 曜日 (0:日曜, 1:月曜, …, 6:土曜)
– day_of_year: 1月1日からの経過日数 (0-365)

3. 具体的な使い方・実践サンプルコード

以下は、EA（エキスパートアドバイザー）で「金曜日のサーバー時間22時以降に、新規エントリーを禁止する」という実用的なフィルターを実装した例です。

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
{
    // 1. 現在のサーバー時間を取得
    datetime now = TimeCurrent();

    // 2. 日時情報を格納するための構造体変数を宣言
    MqlDateTime time_data;

    // 3. TimeToStructを使って構造体にデータを変換
    if(TimeToStruct(now, time_data))
    {
        // 4. 曜日の判定 (5 = 金曜日) と 時間の判定 (22時以降)
        if(time_data.day_of_week == 5 && time_data.hour >= 22)
        {
            Print("金曜夜間のため、新規エントリーを制限します。");
            return; // 22時以降ならここで処理を終了
        }
    }
    else
    {
        Print("時間の変換に失敗しました。エラーコード: ", GetLastError());
        return;
    }

    // --- ここにメインの取引ロジックを記述 ---
    // 例: if(Signal) OrderSend(...);
}

4. 使用上の注意点とよくあるエラー

曜日の数値に注意

MqlDateTime.day_of_weekは、0が日曜日で、6が土曜日です。他のプログラミング言語やライブラリによっては月曜日を0とするものもあるため、乗り換え直後の開発者は混同しやすく、注意が必要です。

構造体の初期化

MqlDateTime構造体を宣言した際、古いデータが残っていると思わぬ挙動をすることがあります。TimeToStructを呼ぶ直前にZeroMemory(time_data)で初期化するか、必ず戻り値（bool型）を確認して正常に変換された場合のみデータを利用するようにしてください。

サーバー時間とローカル時間の混同

バックテスト時やリアル稼働時、TimeCurrent()（証券会社サーバーの時間）を使っているのか、TimeLocal()（PC自体の時間）を使っているのかを常に意識してください。多くのEAロジックでは、チャートの足に同期するTimeCurrent()を使用するのが一般的です。

5. 【重要】自動売買における約定スピードと環境の罠

アルゴリズムトレーダーとして勝ち続けるためには、コードの最適化以上に「取引環境」が重要です。どれほど優れたロジックをTimeToStructで組んだとしても、ご自宅のPC環境から一般的なインターネット回線を通じて注文を出している場合、物理的な距離に起因するネットワーク遅延（レイテンシ）は避けられません。FX市場の価格はミリ秒単位で変動しており、自宅からの注文が証券会社のサーバーに届く頃には、すでに有利な価格が消え去っていることも珍しくありません。

この約定スピードの差は、スリッページによる「隠れた損失」として確実に利益を削り取ります。プロのクオンツや専業トレーダーにとって、証券会社のサーバーに物理的に近いデータセンターで稼働する「専用のVPS（仮想専用サーバー）」を利用することは、もはやオプションではなく必須条件です。安定した電源、24時間365日の稼働保証、そして極限まで抑えられたネットワーク遅延。このインフラの差こそが、シストレにおける「技術的な優位性」の基盤となるのです。