既刊の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での実行手順
実際に動かして判定を確認する手順です。
- MetaEditorで新規インジケーター「TripleSwapWednesdayAlert」を作成し、上のコードを貼り付ける
- F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- チャートに適用し、実際に水曜日のタイミングでチャート左上のコメント欄を確認する
- 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個で済ませる方がシンプルになります。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント