High-Performance Time Functions (TimeUtils) - MetaTrader 5のためのライブラリ

また、TimeUtils.mqh ファイルに特定の関数の簡単な説明があります。

//+==================================================================+
| コンポーネントからdatetimeを作成|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // 年
   const int mon,            // 月
   const int day,            // 日
   const int hour = 0,       // 時間
   const int min = 0,        // 分
   const int sec = 0         // 秒
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // StructToTime() の高速な代替案

//+==================================================================+
//| ブレイクdatetime コンポーネントへ|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // 変換する日付の値
   MqlDateTime&  dt_struct   価値観を採用するための//構造
   )

//+==================================================================+
//| 日付の構成要素を抽出する：日曜日、yyyy.mm.dd hh:mm:ss｜｜日付の構成要素
//| Get() 単位|
//+==================================================================+
int GetSecond(datetime t)
int GetMinute(datetime t)
int GetHour(datetime t)
int GetDay(datetime t)
int GetMonth(datetime t)
int GetYear(datetime t)

//+==================================================================+
//| Day() Number|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| 週番号|
//+==================================================================+
int WeekOfMonth(const datetime t, bool StartsOnMonday = false)
int WeekOfYear(const datetime t, bool StartsOnMonday = false)
int WeekIndex(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| StartOf() 単位|
//+==================================================================+
datetime StartOfMinute(datetime t)
datetime StartOfHour(datetime t)
datetime StartOfDay(datetime t)
datetime StartOfWeek(datetime t, bool StartsOnMonday = false)
datetime StartOfMonth(datetime t)
datetime StartOfYear(datetime t)

//+==================================================================+
| EndOf() ユニット|
//+==================================================================+
datetime EndOfMinute(datetime t)
datetime EndOfHour(datetime t)
datetime EndOfDay(datetime t)
datetime EndOfWeek(datetime t, bool StartsOnMonday = false)
datetime EndOfMonth(datetime t)
datetime EndOfYear(datetime t)

//+==================================================================+
//| SecsElapsedOf() 単位|
//+==================================================================+
int SecsElapsedOfMinute(datetime t)
int SecsElapsedOfHour(datetime t)
int SecsElapsedOfDay(datetime t)
int SecsElapsedOfWeek(datetime t, bool StartsOnMonday = false)
int SecsElapsedOfMonth(datetime t)
int SecsElapsedOfYear(datetime t)

//+==================================================================+
//| RoundTo() / Nearest() 単位|
//+==================================================================+
datetime RoundToMinute(datetime t)
datetime RoundToHour(datetime t)
datetime RoundToDay(datetime t)
datetime RoundToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| CeilTo() / Next() ユニット|
//+==================================================================+
datetime CeilToMinute(datetime t)
datetime CeilToHour(datetime t)
datetime CeilToDay(datetime t)
datetime CeilToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| Next() 平日|
//+==================================================================+
datetime NextWeekday(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime NextSunday(datetime t)
datetime NextMonday(datetime t)
datetime NextTuesday(datetime t)
datetime NextWednesday(datetime t)
datetime NextThursday(datetime t)
datetime NextFriday(datetime t)
datetime NextSaturday(datetime t)

//+==================================================================+
//| 前へ() 平日|
//+==================================================================+
datetime PreviousWeekday(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime PreviousSunday(datetime t)
datetime PreviousMonday(datetime t)
datetime PreviousTuesday(datetime t)
datetime PreviousWednesday(datetime t)
datetime PreviousThursday(datetime t)
datetime PreviousFriday(datetime t)
datetime PreviousSaturday(datetime t)

//+==================================================================+
//| Nth() 今月の平日|
//+==================================================================+
datetime FirstWeekdayOfTheMonth(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime LastWeekdayOfTheMonth(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime NthWeekdayOfTheMonth(datetime t, int Nth, ENUM_DAY_OF_WEEK weekday = SUNDAY)

//+==================================================================+
//| Add() ユニット|
//+==================================================================+
datetime AddSeconds(datetime t, int amount)
datetime AddMinutes(datetime t, int amount)
datetime AddHours(datetime t, int amount)
datetime AddDays(datetime t, int amount)
datetime AddBusinessDays(datetime t, int amount)
datetime AddWeeks(datetime t, int amount)
datetime AddMonths(datetime t, int amount)
datetime AddYears(datetime t, int amount)

//+==================================================================+
//| Sub() ユニット|
//+==================================================================+
datetime SubSeconds(datetime t, int amount)
datetime SubMinutes(datetime t, int amount)
datetime SubHours(datetime t, int amount)
datetime SubDays(datetime t, int amount)
datetime SubBusinessDays(datetime t, int amount)
datetime SubWeeks(datetime t, int amount)
datetime SubMonths(datetime t, int amount)
datetime SubYears(datetime t, int amount)

//+==================================================================+
| DifferenceIn() 単位|
//+==================================================================+
int DifferenceInCalendarDays(datetime beginTime, datetime endTime)
int DifferenceInBusinessDays(datetime beginTime, datetime endTime)
int DifferenceInCalendarWeeks(datetime beginTime, datetime endTime, bool StartsOnMonday = false)
int DifferenceInCalendarMonths(datetime beginTime, datetime endTime)

//+==================================================================+
//| IsSame() ユニット|
//+==================================================================+
bool IsSameMinute(datetime t1, datetime t2)
bool IsSameHour(datetime t1, datetime t2)
bool IsSameDay(datetime t1, datetime t2)
bool IsSameWeek(datetime t1, datetime t2, bool StartsOnMonday = false)
bool IsSameMonth(datetime t1, datetime t2)
bool IsSameYear(datetime t1, datetime t2)

//+==================================================================+
//| IsCurrent() ユニット|
//+==================================================================+
bool IsCurrentMinute(datetime t)
bool IsCurrentHour(datetime t)
bool IsCurrentWeek(datetime t, bool StartsOnMonday = false)
bool IsCurrentMonth(datetime t)
bool IsCurrentYear(datetime t)
bool IsToday(datetime t)
bool IsTomorrow(datetime t)
bool IsYesterday(datetime t)

//+==================================================================+
//| その他|
//+==================================================================+
bool IsLeapYear(int year)
int  DaysInMonth(int year, int month)
datetime GetNthWeekdayInYearMonth(iYear, iMonth, Nth, weekday = SUNDAY)
datetime GetNthSundayInYearMonth(iYear, iMonth, Nth)

//+==================================================================+
| 時間を文字列に変換する|
//+==================================================================+
string t2s(datetime t, const int mode = TIME_DATE | TIME_MINUTES)
string SecondsToString(int seconds)
string TimeFormat(datetime t, string format = "YYYY.MM.DD hh:mm")

利用可能なすべての時間フォーマットのリスト:

//+------------------------------------------------------------------+
//| 渡されたトークンの文字列に従って、フォーマットされた時刻を取得する。|
//| 利用可能なすべてのフォーマットのリスト：|
//| フォーマット出力の説明|
//| ------  ----------------  -------------------------------------  |
//| 年｜YY 18二桁の年
| YYYY 2018 4桁の西暦|
//| M 1-121 から始まる月
//| 月｜MM 01-12月、2桁
//| MMM Jan-Dec 月名の省略形、3文字。
//| MMMM 1月～12月 完全な月名|
//| D 1-31月日
//| DD 01-312桁の月日。
//| DDD Sun-Sat 曜日の略称。
//| DDDD 日曜日～土曜日 曜日名
//| h 0-23 時|
//| hh 00-23時、2桁
//| H 1-12時、12時間時計
//| HH 01-12 時、12時間表示、2桁
//| m 0-59 分|
//| mm 00-59分（2桁
//| 秒|
|秒 00-592桁目
//| 午前午後|
||午前午後|
//+------------------------------------------------------------------+
//| サンプルのフォーマット：|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05"(デフォルト)
//| DDD、YYYY.MM.DD hh:mm:ss"//"2024.12.08（日）22:05:21"
//| D MMMM YYYY, HH:mm a" // "2024年12月8日午後10時5分" | | "D MMMM YYYY, HH:mm a" // "2024年12月8日午後10時5分
| "dd/mm/yyyy" // "08/12/2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : 初期リリース。

2024.12.05 - v.1.15 : 営業日およびNth()平日の関数を追加。DaysInMonth()関数の計算を最適化。

2024.12.09 - v.1.20 :渡されたトークン文字列に従って時刻をフォーマットするTimeFormat()関数を追加。

2024.12.09 - v.1.25 : TimeToStructFast()関数の計算を最適化。

2024.12.10 - v.1.30 : TimeFormat()、StartOfYear()、EndOfYear()関数の最適化。いくつかの関数の説明を更新。

2024.12.15 - v.1.35 :GetNthWeekdayInYearMonth()関数を最適化。

2024.12.18 - v.1.40 :IsCurrentXXX(), IsToday(), IsTomorrow(), IsYesterday()関数を追加。

2024.12.19 - v.1.45 :AddMonths()関数とGetNthWeekdayInYearMonth()関数を最適化しました。

2024.12.20 - v.1.50 : 更なるコードのクリーンアップ。

2024.12.21 - v.1.55 : AddMonths()の計算を簡素化: 月と年を調整する複雑なロジックを、より単純な合計月の計算に置き換え。