High-Performance Time Functions (TimeUtils) - MetaTrader 5程序库

函数名称不言自明；您还可以在 TimeUtils.mqh 文件中找到特定函数的简短说明。

//+==================================================================+
//| 从组件创建日期时间|
//+==================================================================+
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()

//+==================================================================+
//| Break datetime To Components|
//+==================================================================+
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)

//+==================================================================+
//| Week() Number|
//+==================================================================+
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)

//+==================================================================+
//| Previous() 平日|
//+==================================================================+
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 四位数年份|
//| M 1-12从 1 开始的月份
//| MM 01-12月份，两位数
//| MMM Jan-Dec 月份缩写名称，3 个字母。
//| MMMM 1 月-12 月 月份全称|
//| D 1-31月的星期
//| DD 01-31月日，两位数 | |
//| DDD 星期日-星期六 一周中一天的简称。
//| DDDD 星期日-星期六 星期天的名称
//| h 0-23 小时|
//| hh 00-23小时，两位数
//| H 1-12小时，12 小时钟
//| HH 01-12 小时，12 小时钟，2 位数
//| m 0-59 分钟|
//| 毫米 00-59分钟，两位数
//| s 0-59 秒|
//| ss 00-59第二个 2 位数
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| 样本格式：|
//| "YYYY.MM.DD hh:mm"//"2024.12.08 22:05"（默认） || "YYYY.MM.DD hh:mm"。
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" | | "Sun, 2024.12.08 22:05:21
//|"D MMMM YYYY, HH:mm a" //"8 December 2024, 10:05 pm" |
//|"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 : 添加了工作日和每月第 N 个()工作日的函数。优化了 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() 中的计算：以更简单的总月数计算取代复杂的年月调整逻辑。