High-Performance Time Functions (TimeUtils) - biblioteca para MetaTrader 5

Os nomes das funções devem ser autoexplicativos; além disso, você pode encontrar uma breve descrição de uma função específica no arquivo TimeUtils.mqh.

//+==================================================================+
//| Criar datetime a partir de componentes|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Ano
   const int mon,            // Mês
   const int day,            // Dia
   const int hour = 0,       // Hora
   const int min = 0,        // Minutos
   const int sec = 0         // Segundos
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // alternativa rápida para StructToTime()

//+==================================================================+
//| Quebrar datetime para componentes|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Valor de data a ser convertido
   MqlDateTime&  dt_struct   // estrutura para a adoção de valores
   )

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

//+==================================================================+
//| Day() Número|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

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

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

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

//+==================================================================+
//| Anterior() Dia da 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() Dia da semana do mês|
//+==================================================================+
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)

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

//+==================================================================+
//| Formando o tempo como string|
//+==================================================================+
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 os formatos de hora disponíveis:

//+------------------------------------------------------------------+
//| Obter a hora formatada de acordo com a cadeia de tokens passada. |
//| Lista de todos os formatos disponíveis:|
//| Descrição do formato de saída|
//| ------ ---------------- ------------------------------------- |
//| YY 18Ano com dois dígitos
//| YYYY 2018 Ano com quatro dígitos|
//| M 1-12O mês, começando em 1
//| MM 01-12 O mês, 2 dígitos
//| MMM Jan-Dez O nome abreviado do mês, 3 letras
//| MMMM Janeiro-Dezembro O nome completo do mês|
//| D 1-31O dia do mês
//| DD 01-31O dia do mês, 2 dígitos
//| DDD Sun-Sat O nome abreviado do dia da semana.
//| DDDD Domingo-Sábado O nome do dia da semana
//| h 0-23 A hora|
//| hh 00-23 A hora, 2 dígitos
//| H 1-12A hora, relógio de 12 horas
//| HH 01-12 A hora, relógio de 12 horas, 2 dígitos
//| m 0-59 O minuto|
//| mm 00-59 O minuto, 2 dígitos
//| s 0-59 O segundo|
//| ss 00-59 O segundo, de 2 dígitos
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Formatos de amostra:|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05" (padrão)
//| "DDD, YYYY.MM.DD hh:mm:ss"   // "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 : Versão inicial.

2024.12.05 - v.1.15 : Funções adicionadas para dias úteis e para Nth() dia da semana do mês. Cálculos otimizados na função DaysInMonth().

2024.12.09 - v.1.20 : Adicionada a função TimeFormat() para formatar a hora de acordo com a string de tokens passada.

2024.12.09 - v.1.25: Cálculos otimizados na função TimeToStructFast().

2024.12.10 - v.1.30: Funções TimeFormat(), StartOfYear() e EndOfYear() otimizadas. Atualizadas as descrições de algumas funções.

2024.12.15 - v.1.35 : Otimizada a função GetNthWeekdayInYearMonth().

2024.12.18 - v.1.40 : Adicionadas as funções IsCurrentXXX(), IsToday(), IsTomorrow() e IsYesterday().

2024.12.19 - v.1.45 : Funções AddMonths() e GetNthWeekdayInYearMonth() otimizadas.

2024.12.20 - v.1.50: Mais limpeza de código.

2024.12.21 - v.1.55 : Cálculos simplificados em AddMonths(): substituiu a lógica complexa de ajuste de meses e anos por um cálculo mais simples do total de meses.