High-Performance Time Functions (TimeUtils) - librería para MetaTrader 5

Los nombres de las funciones deberían explicarse por sí mismos; además, puede encontrar una breve descripción de una función específica en el archivo TimeUtils.mqh.

//+==================================================================+
//| Crear fecha a partir de componentes|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Año
   const int mon,            // Mes
   const int day,            // Día
   const int hour = 0,       // Hora
   const int min = 0,        // Minutos
   const int sec = 0         // Segundos
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // alternativa rápida a StructToTime()

//+==================================================================+
//| Break datetime To Components|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Valor de fecha a convertir
   MqlDateTime&  dt_struct   // estructura para la adopción de valores
   )

//+==================================================================+
//| Extraer componentes de datetime: Sunday, yyyy.mm.dd hh:mm:ss |
//| Unidades 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)

//+==================================================================+
//| Día() Número|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| Semana() Número|
//+==================================================================+
int WeekOfMonth(const datetime t, bool StartsOnMonday = false)
int WeekOfYear(const datetime t, bool StartsOnMonday = false)
int WeekIndex(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| Unidades 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)

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

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

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

//+==================================================================+
//| Next() Día de la semana|
//+==================================================================+
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() Día de la semana|
//+==================================================================+
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() Día de la semana del mes|
//+==================================================================+
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)

//+==================================================================+
//| Unidades 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)

//+==================================================================+
//| Unidades 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)

//+==================================================================+
//| Unidades 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)

//+==================================================================+
//| Unidades 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)

//+==================================================================+
//| Unidades 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)

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

//+==================================================================+
//| Formatear Hora a Cadena|
//+==================================================================+
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")

Lista de todos los formatos de hora disponibles:

//+------------------------------------------------------------------+
//| Obtener la hora formateada según la cadena de tokens pasada. |
//| Lista de todos los formatos disponibles:|
//| Formato Salida Descripción|
//| ------ ---------------- ------------------------------------- |
//| YY 18Año de dos dígitos
//| AAAA 2018 Año de cuatro cifras|
//| M 1-12El mes, empezando por 1 |
//| MM 01-12 El mes, 2 dígitos |
//| MMM Ene-Dic El nombre abreviado del mes, 3 letras |
//| MMMM Enero-Diciembre El nombre completo del mes|
//| D 1-31El día del mes |
//| DD 01-31El día del mes, 2 dígitos |
//| DDD Sun-Sat El nombre abreviado del día de la semana || DDD Sun-Sat
//| DDDD Domingo-Sábado El nombre del día de la semana ||| DDDD Domingo-Sábado
//| h 0-23 La hora|
//| hh 00-23 La hora, 2 dígitos |
//| H 1-12La hora, reloj de 12 horas |
//| HH 01-12 La hora, reloj de 12 horas, 2 dígitos |
//| m 0-59 El minuto|
//| mm 00-59 El minuto, 2 dígitos |
//| s 0-59 El segundo|
//| ss 00-59 El segundo, de 2 dígitos |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Formatos de muestra:|
//| "AAAA.MM.DD hh:mm" // "2024.12.08 22:05" (por defecto) || "2024.12.08 22:05" (por defecto)
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" ||
//| "D MMMM AAAA, HH:mm a" // "8 de diciembre de 2024, 22:05" |
//| "DD/MM/AAAA" // "08/12/2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : Versión inicial.

2024.12.05 - v.1.15 : Añadidas funciones para días laborables y para Nth() día de la semana del mes. Optimizados los cálculos en la función DaysInMonth().

2024.12.09 - v.1.20 : Añadida función TimeFormat() para dar formato a la hora según la cadena de tokens pasada.

2024.12.09 - v.1.25 : Optimizados los cálculos en la función TimeToStructFast().

2024.12.10 - v.1.30 : Optimizadas las funciones TimeFormat(), StartOfYear() y EndOfYear(). Actualizadas las descripciones de algunas funciones.

2024.12.15 - v.1.35 : Optimizada la función GetNthWeekdayInYearMonth().

2024.12.18 - v.1.40 : Añadidas las funciones IsCurrentXXX(), IsToday(), IsTomorrow() y IsYesterday().

2024.12.19 - v.1.45 : Optimizadas las funciones AddMonths() y GetNthWeekdayInYearMonth().

2024.12.20 - v.1.50 : Más limpieza de código.

2024.12.21 - v.1.55 : Simplificados los cálculos en AddMonths(): sustituida la compleja lógica de ajuste de meses y años por un cálculo más simple del total de meses.