既刊のGMT+9時間計算の記事や、

ログフォルダを年月で振り分ける記事では、

TimeToStructという関数を当たり前のように使っていました。

ただ、この関数自体の仕組みは、どの記事でも説明していませんでした。

この記事では、TimeToStructとMqlDateTime構造体の使い方を、

水曜日だけ「今日はトリプルスワップデーです」と、

警告するインジケーターの実装例で解説します。

この記事で分かること
・TimeToStructとMqlDateTime構造体の仕組み
・StructToTimeによる逆変換の使い方
・TimeDayOfWeek等の個別関数との違い
・水曜トリプルスワップデー判定の実際に動くコード

TimeToStructとは何か

まず、この関数が解決する問題を整理します。

既刊記事群での「暗黙の使用」

既刊FolderCreate/FolderDeleteの記事は、

ログを年月フォルダに振り分ける処理で、

TimeToStructを使って年と月を取り出していました。

1回の呼び出しで複数の値がまとめて取れる

補足
・年・月・日・時・分・秒・曜日・年間通算日を一度に取得できる
・個別の関数を何度も呼ぶより、構造体1個で済む
・MQL4・MQL5の両方に同じ名前・同じ使い方で存在する

年と曜日の両方が必要な場面で、関数を2回呼ぶか構造体を1回呼ぶかは、

書きやすさに差が出ます。

シグネチャとMqlDateTime構造体

公式リファレンスで仕組みを確認します。

シグネチャ

公式リファレンス(TimeToStruct)によると、シグネチャは次の通りです。

void TimeToStruct(
   datetime dt,                 //分解したい日時
   MqlDateTime& dt_struct  //結果を受け取る構造体(参照渡し)
);

第2引数は参照渡しのため、先に空のMqlDateTime構造体を宣言してから渡します。

MqlDateTime構造体のメンバー

公式リファレンス(MqlDateTime)によると、8個のintメンバーがあります。

メンバー 意味
year 年(4桁)
mon 月(1〜12)
day 日(1〜31)
hour 時(0〜23)
min 分(0〜59)
sec 秒(0〜59)
day_of_week 曜日(日曜=0〜土曜=6)
day_of_year 年初からの通算日(1月1日=0)

day_of_yearの落とし穴

注意
・day_of_yearは1月1日が0から始まる
・3月以降はうるう年かどうかで同じ日付でも値が1ずれる
・年をまたぐ日数計算に使う場合は要注意

StructToTimeによる逆変換

分解した値を書き換えて、datetime型に戻すこともできます。

組み立てに使う主なメンバー

StructToTimeは、

MqlDateTime構造体のyear/mon/day/hour/min/secから、

datetime型の値を組み立てて返します。

「分解して書き換えて戻す」という使い方

例えば、ある日時のhourだけを9に変更し、

StructToTimeで戻せば、「同じ日の午前9時」を表すdatetime値が作れます。

TimeDayOfWeek等の個別関数との違い

既刊server-time-jst-indicator-mt4.mdと比較します。

既刊記事は個別関数の組み合わせだった

既刊サーバー時刻の記事は、

TimeGMT()・TimeLocal()・TimeCurrent()という、

用途ごとの個別関数を使う設計でした。

曜日と時刻を同時に使うならTimeToStruct

TimeDayOfWeek()で曜日を、

Hour()・Minute()で時刻を、

それぞれ別々に呼ぶ代わりに、

TimeToStruct1回でまとめて取得できます。

実際に動くコード全体:水曜トリプルスワップデー警告

多くのFXブローカーでは、

水曜から木曜に日付が変わる瞬間のスワップが、

土日分を含めて3倍になる慣行があります。

//+------------------------------------------------------------------+
//|                                TripleSwapWednesdayAlert.mq4       |
//|                     Copyright 2026, FX-EA System Project Creator |
//|                        https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict
#property indicator_chart_window

datetime lastAlertedDay = 0;

//+------------------------------------------------------------------+
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
int OnCalculate(const int rates_total,
                const int prev_calculated,
                const datetime &time[],
                const double &open[],
                const double &high[],
                const double &low[],
                const double &close[],
                const long &tick_volume[],
                const long &volume[],
                const int &spread[])
  {
   MqlDateTime now;
   TimeToStruct(TimeCurrent(), now);

   datetime today = TimeCurrent() - now.hour * 3600
                     - now.min * 60 - now.sec;

   if(now.day_of_week == 3 && today != lastAlertedDay)
     {
      lastAlertedDay = today;
      Comment("本日は水曜日: トリプルスワップデーです");
      Alert(Symbol(), " 本日はトリプルスワップデーです");
     }

   return(rates_total);
  }
//+------------------------------------------------------------------+

day_of_weekで水曜日を判定する

公式リファレンス通り、

day_of_week==3が水曜日に対応します。

1日1回だけ警告する仕組み

lastAlertedDayに「時刻を除いた日付」を保存し、

同じ日に何度もAlertが出ないようにしています。

MetaEditorでの実行手順

実際に動かして判定を確認する手順です。

  1. MetaEditorで新規インジケーター「TripleSwapWednesdayAlert」を作成し、上のコードを貼り付ける
  2. F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  3. チャートに適用し、実際に水曜日のタイミングでチャート左上のコメント欄を確認する
  4. TimeCurrent()はサーバー時刻を返すため、PCの時計を変えても判定には反映されない点に注意する

よくあるエラーと注意点

実装時につまずきやすい点をまとめます。

構造体は先に宣言してから渡す

MqlDateTime型の変数を先に用意せず、

関数呼び出しの中で直接作ろうとすると、

コンパイルエラーになります。

day_of_weekは日曜=0から始まる

月曜=1と思い込んで実装すると、

曜日の判定が1日ずれてしまいます。

MQL4とMQL5で全く同じ書き方が使える

TimeToStruct/StructToTime/MqlDateTimeは、

MQL4・MQL5のどちらでも、

同じ関数名・同じメンバー名で使えます。

スワップが実際に3倍になる曜日はブローカー次第

水曜トリプルスワップは多くの業者で見られる慣行ですが、

公式な統一ルールではないため、

実際の付与曜日は必ず自分の口座で確認してください。

よくある質問

TimeToStructについて、よく検索される疑問に回答します。

TimeCurrent()をそのまま比較してはいけませんか?

秒単位まで一致を求める比較には使えますが、

「同じ日かどうか」のような粒度の比較には、

構造体に分解してyear/mon/dayだけ見る方が確実です。

サーバー時刻とローカル時刻のどちらを渡すべきですか?

既刊server-time-jst-indicator-mt4.mdの通り、

曜日判定はブローカーのサーバー時刻を基準にするのが一般的です。

TimeCurrent()はサーバー時刻を返します。

構造体のメンバーを直接書き換えてもいいですか?

書き換え自体は可能ですが、

StructToTimeで戻すまでは元のdatetime値には反映されません。

【MQL4/MQL5】TimeToStruct関数とMqlDateTime構造体で日時を分解する方法について解説してみた(StructToTimeでの逆変換・水曜トリプルスワップ判定の実装例):まとめ

TimeToStructは、既刊記事群が当たり前のように使っていた、

日時を8つの値に分解するための基本関数です。

年・曜日・時刻をまとめて使いたい場面では、

個別関数を何度も呼ぶより、

この構造体1個で済ませる方がシンプルになります。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事