高性能时间函数 (TimeUtils) - MetaTrader 5 库

该库包含 80 多个不同的函数来处理时间变量。主要目标是提供高性能时间函数。默认情况下禁用性能模式（可以在编译时通过 #define 进行控制）。此模式不需要将库包含到您的项目中，因为没有它也可以正常包含。

TIMEUTILS_PERFORMANCE_MODE

可选地， 性能模式可以在编译时打开通过#include之前的#defines：

// 为库启用性能模式
＃定义TIMEUTILS_PERFORMANCE_MODE＃包括“TimeUtils.mqh”

这会将所有调用重定向到 MQL 的内置构建时间和结构到时间 功能到更有效的替代方案。

您可以使用或不使用 TIMEUTILS_PERFORMANCE_MODE 来编译脚本“performance_mode.mq5” 检查您机器上的速度差异。这将有利于高性能程序执行繁重或许多与时间相关的任务（例如，在交易周开始时扫描 H1 柱的所有报价历史记录或收集其他统计数据）。

函数名称应该是不言自明的；此外，您还可以在 TimeUtils.mqh 文件中找到特定函数的简短描述。

//+====================================================================+
//|从组件创建日期时间                                  |
//+====================================================================+
日期时间创建日期时间(
  常量 整数年，          // 年  常量 整数星期一，            // 月  常量 整数天，            // 天  常量 整数小时=0,      // 小时  常量 整数分钟=0,        // 分钟  常量 整数秒=0        // 秒   ）日期时间创建日期时间(Mql日期时间&  dt_struct);  // StructToTime() 的快速替代方法

//+====================================================================+
//|将日期时间分解为组件                                     |
//+====================================================================+
布尔值快速结构时间(
  日期时间      德特，        // 要转换的日期值  Mql日期时间&  dt_struct  // 采用值的结构   ）//+====================================================================+
//|提取日期时间的组成部分：星期日，yyyy.mm.dd hh:mm:ss      |
//| Get() 单位                                                      |
//+====================================================================+
整数获取第二个（日期时间t)整数获取分钟(日期时间t)整数获取时间（日期时间t)整数获取日（日期时间t)整数获取月份(日期时间t）整数获取年份(日期时间t)//+====================================================================+
//| Day() 数字                                                     |
//+====================================================================+
整数星期几(日期时间t)整数年中的某一天（日期时间t)整数日指数(日期时间t)//+====================================================================+
//|周数                                                    |
//+====================================================================+
整数每月一周（常量 日期时间t,布尔值周一开始 =错误的）整数一年中的一周(常量 日期时间t,布尔值周一开始 =错误的）整数周索引(日期时间t,布尔值周一开始 =错误的）//+====================================================================+
//| StartOf() 单位                                                  |
//+====================================================================+
日期时间分钟开始（日期时间t）日期时间开始时间（日期时间t)日期时间一天的开始（日期时间t）日期时间一周开始（日期时间t,布尔值周一开始 =错误的）日期时间月初（日期时间t）日期时间年初（日期时间t）//+====================================================================+
//| EndOf() 单位                                                    |
//+====================================================================+
日期时间分钟结束（日期时间t)日期时间结束时间（日期时间t）日期时间一天结束（日期时间t）日期时间周结束（日期时间t,布尔值周一开始=错误的）日期时间月末（日期时间t）日期时间年末（日期时间t)//+====================================================================+
//| SecsElapsedOf() 单位                                           |
//+====================================================================+
整数分钟秒数（日期时间t）整数秒数已用时间（日期时间t)整数天已过秒数（日期时间t)整数周已过去秒数（日期时间t,布尔值周一开始 =错误的）整数月已过去秒数（日期时间t)整数年已过去秒数（日期时间t）//+====================================================================+
//| RoundTo() / 最近() 单位                                       |
//+====================================================================+
日期时间回合到分钟（日期时间t)日期时间回合到小时（日期时间t)日期时间今天回合（日期时间t）日期时间每周循环（日期时间t,布尔值周一开始=错误的）//+====================================================================+
//| CeilTo() / Next() 单位                                          |
//+====================================================================+
日期时间天花板到分钟(日期时间t）日期时间天花板到小时（日期时间t）日期时间今日天花板(日期时间t）日期时间天花板到周（日期时间t,布尔值周一开始 =错误的）//+====================================================================+
//|下一个() 工作日                                                   |
//+====================================================================+
日期时间下一个工作日(日期时间t,ENUM_DAY_OF_WEEK工作日 =星期日）日期时间下周日(日期时间t)日期时间下周一（日期时间t)日期时间下周二（日期时间t）日期时间下周三(日期时间t)日期时间下周四(日期时间t)日期时间下周五(日期时间t）日期时间下周六(日期时间t)//+====================================================================+
//|上一页() 工作日                                                |
//+====================================================================+
日期时间上一个工作日(日期时间t,ENUM_DAY_OF_WEEK工作日 =星期日）日期时间上周日(日期时间t)日期时间上周一(日期时间t）日期时间上周二(日期时间t)日期时间上周三(日期时间t）日期时间上周四(日期时间t）日期时间上周五(日期时间t）日期时间上周六(日期时间t）//+====================================================================+
//|该月的第 N() 个工作日                                       |
//+====================================================================+
日期时间该月的第一个工作日（日期时间t,ENUM_DAY_OF_WEEK工作日 =星期日）日期时间该月最后一个工作日(日期时间t,ENUM_DAY_OF_WEEK工作日 =星期日）日期时间本月第 N 个工作日（日期时间t,整数第N次，ENUM_DAY_OF_WEEK工作日 =星期日）//+====================================================================+
//| Add() 单位                                                       |
//+====================================================================+
日期时间添加秒数（日期时间t,整数数量）日期时间添加分钟数(日期时间t,整数数量）日期时间添加时间(日期时间t,整数数量）日期时间添加天数(日期时间t,整数数量）日期时间添加工作日(日期时间t,整数数量）日期时间添加周数（日期时间t,整数数量）日期时间添加月份（日期时间t,整数数量）日期时间添加年份(日期时间t,整数数量）//+====================================================================+
//| Sub() 单位                                                      |
//+====================================================================+
日期时间亚秒(日期时间t,整数数量）日期时间亚分​​钟(日期时间t,整数数量）日期时间低于小时数（日期时间t,整数数量）日期时间子日(日期时间t,整数数量）日期时间子营业日(日期时间t,整数数量）日期时间子周（日期时间t,整数数量）日期时间子月份(日期时间t,整数数量）日期时间子年份(日期时间t,整数数量）//+====================================================================+
//| DifferenceIn() 单位                                             |
//+====================================================================+
整数日历天数差异(日期时间开始时间，日期时间结束时间）整数工作日差异（日期时间开始时间，日期时间结束时间）整数日历周差异(日期时间开始时间，日期时间结束时间，布尔值周一开始 =错误的）整数日历月份差异(日期时间开始时间，日期时间结束时间）//+====================================================================+
//| IsSame() 单位                                                    |
//+====================================================================+
布尔值是同一分钟（日期时间t1,日期时间t2)布尔值是同一时间（日期时间t1,日期时间t2)布尔值是同一天（日期时间t1,日期时间t2)布尔值是同一周（日期时间t1,日期时间t2,布尔值周一开始=错误的）布尔值是同月（日期时间t1,日期时间t2)布尔值同年(日期时间t1,日期时间t2)//+====================================================================+
//| IsCurrent() 单位                                                 |
//+====================================================================+
布尔值是当前分钟(日期时间t)布尔值是当前时间(日期时间t)布尔值是当前周（日期时间t,布尔值周一开始 =错误的）布尔值是当前月份(日期时间t)布尔值是当前年份(日期时间t）布尔值今天是（日期时间t）布尔值是明天（日期时间t)布尔值是昨天（日期时间t)//+====================================================================+
//|其他                                                             |
//+====================================================================+
布尔值是闰年(整数年）整数  一个月中的天数（整数年，整数月）日期时间GetNthWeekdayInYearMonth(iYear, iMonth, Nth, 工作日 =星期日）日期时间GetNthSundayInYearMonth(iYear, iMonth, Nth)//+====================================================================+
//|将时间格式化为字符串                                        |
//+====================================================================+
细绳t2s(日期时间t,常量 整数模式=TIME_DATE|TIME_MINUTES）细绳秒数转字符串(整数秒）细绳时间格式(日期时间t,细绳格式=“年.月.日 时:分”）

//+------------------------------------------------------------------+
//|根据传递的 token 字符串获取格式化时间。 |
//|所有可用格式的列表：                                   |
//|格式  输出            说明                            |
//| ------  ----------------  ---------------------------------------------------- |
//| YY      18                两位数年份                         |
//| YYYY    2018              四位数年份                        |
//| M       1-12              月份，从 1 开始              |
//| MM      01-12             月份，2 位数字                    |
//| MMM     Jan-Dec           月份名称缩写，3 个字母  |
//| MMMM    一月至十二月  完整月份名称                    |
//| D       1-31              一月中的某一天                   |
//| DD      01-31             月份中的日期，2 位数字         |
//| DDD     周日至周六           一周中某一天的简称  |
//| DDDD    星期日至星期六   星期几的名称        |
//| h       0-23              小时                               |
//| hh      00-23             小时，2 位数字                     |
//| H       1-12              小时，12 小时制                |
//| HH      01-12             小时，12 小时制，2 位数字      |
//| m       0-59              分钟                             |
//| mm      00-59             分钟，2 位数字                   |
//| s       0-59              第二个                             |
//| ss      00-59             第二个 2 位数字                   |
//| A       上午 下午                                                   |
//| a       上午                                                   |
//+------------------------------------------------------------------+
//|示例格式：                                                 |
//| "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:05”      |
//| "DD/MM/YYYY"                 // "08/12/2024"                      |
//+------------------------------------------------------------------+
细绳时间格式(常量 日期时间t,常量 细绳格式=“年.月.日 时:分”）；