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()

//+==================================================================+
//| Разбить datetime на компоненты|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Значение даты для преобразования
   MqlDateTime&  dt_struct   // структура для принятия ценностей
   )

//+==================================================================+
//| Извлеките компоненты datetime: Воскресенье, yyyy.mm.dd hh:mm:ss |
//| Get() Units|
//+==================================================================+
int GetSecond(datetime t)
int GetMinute(datetime t)
int GetHour(datetime t)
int GetDay(datetime t)
int GetMonth(datetime t)
int GetYear(datetime t)

//+==================================================================+
//| День() Число|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
datetime RoundToMinute(datetime t)
datetime RoundToHour(datetime t)
datetime RoundToDay(datetime t)
datetime RoundToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| CeilTo() / Next() Units|
//+==================================================================+
datetime CeilToMinute(datetime t)
datetime CeilToHour(datetime t)
datetime CeilToDay(datetime t)
datetime CeilToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| Next() Weekday|
//+==================================================================+
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() Weekday Of The Month|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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() Units|
//+==================================================================+
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)

//+==================================================================+
//| Misc|
//+==================================================================+
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 Январь-декабрь Полное название месяца|
//| D 1-31День месяца |
//| DD 01-31День месяца, двузначное число |
//| DDD Sun-Sat Краткое название дня недели |
//| DDDD Sunday-Saturday Название дня недели |
//| h 0-23 Час|
//| hh 00-23 Час, двузначное число |
//| H 1-12Час, 12-часовые часы |
//| HH 01-12 Час, 12-часовые часы, 2-значные |
//| m 0-59 Минута|
//| mm 00-59 Минута, двузначное число |
//| s 0-59 Второй|
//| ss 00-59 Вторая, двузначная цифра |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Образцы форматов:|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05" (по умолчанию)|
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" |
//| "D MMMM YYYY, HH:mm a" // "8 декабря 2024, 10:05 pm" |
//| "DD/MM/YYY" // "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(): сложная логика корректировки месяцев и лет заменена на более простой расчет общего количества месяцев.