High-Performance Time Functions (TimeUtils) - libreria per MetaTrader 5

I nomi delle funzioni dovrebbero essere autoesplicativi; inoltre, è possibile trovare una breve descrizione di una funzione specifica nel file TimeUtils.mqh.

//+==================================================================+
//| Creare datetime da componenti|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Anno
   const int mon,            // Mese
   const int day,            // Giorno
   const int hour = 0,       // Ora
   const int min = 0,        // Minuti
   const int sec = 0         // Secondi
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // alternativa veloce a StructToTime()

//+==================================================================+
//| Interrompere datetime in Componenti|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Valore della data da convertire
   MqlDateTime&  dt_struct   // struttura per l'adozione dei valori
   )

//+==================================================================+
//| Estrarre i componenti di datetime: Domenica, yyyy.mm.dd hh:mm:ss |
//| Unità 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)

//+==================================================================+
//| Giorno() Numero|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| Settimana() Numero|
//+==================================================================+
int WeekOfMonth(const datetime t, bool StartsOnMonday = false)
int WeekOfYear(const datetime t, bool StartsOnMonday = false)
int WeekIndex(datetime t, bool StartsOnMonday = false)

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

//+==================================================================+
//| Unità 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() 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() Unità|
//+==================================================================+
datetime RoundToMinute(datetime t)
datetime RoundToHour(datetime t)
datetime RoundToDay(datetime t)
datetime RoundToWeek(datetime t, bool StartsOnMonday = false)

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

//+==================================================================+
//| Prossimo() Giorno della settimana|
//+==================================================================+
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)

//+==================================================================+
//| Precedente() Giorno della settimana|
//+==================================================================+
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() Giorno della settimana del mese|
//+==================================================================+
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)

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

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

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

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

//+==================================================================+
//| Formattazione del tempo in stringa|
//+==================================================================+
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")

Elenco di tutti i formati temporali disponibili:

//+------------------------------------------------------------------+
//| Ottenere l'ora formattata in base alla stringa di token passata. |
//| Elenco di tutti i formati disponibili:|
//| Formato Descrizione dell'uscita|
//| ------ ---------------- ------------------------------------- |
//| YY 18Anno a due cifre
//| YYYY 2018 Anno a quattro cifre|
//| M 1-12Il mese, a partire da 1 |
//| MM 01-12 Il mese, a 2 cifre.
//| MMM gen-dic Il nome abbreviato del mese, 3 lettere |
//| MMMM gennaio-dicembre Il nome completo del mese|
//| D 1-31Il giorno del mese |
//| DD 01-31Il giorno del mese, a 2 cifre.
//| DDD Sun-Sat Il nome breve del giorno della settimana |
//| DDDD domenica-sabato Il nome del giorno della settimana |
//| h 0-23 L'ora|
//| hh 00-23 L'ora, a 2 cifre
//| H 1-12L'ora, orologio a 12 ore |
//| HH 01-12 L'ora, orologio a 12 ore, 2 cifre.
//| m 0-59 Il minuto|
//| mm 00-59 Il minuto, a 2 cifre
//| s 0-59 Il secondo|
//| ss 00-59 Il secondo, a 2 cifre |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Formati di esempio:|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05" (predefinito) |
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" |
//| "D MMMM YYYY, HH:mm a" // "8 dicembre 2024, ore 22:05" |
//| "GG/MM/AAAA" // "08/12/2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : Rilascio iniziale.

2024.12.05 - v.1.15 : Aggiunte funzioni per i giorni lavorativi e per il giorno Nth() del mese. Ottimizzazione dei calcoli nella funzione DaysInMonth().

2024.12.09 - v.1.20 : Aggiunta la funzione TimeFormat() per formattare l'ora in base alla stringa di token passata.

2024.12.09 - v.1.25 : Ottimizzati i calcoli nella funzione TimeToStructFast().

2024.12.10 - v.1.30 : Ottimizzate le funzioni TimeFormat(), StartOfYear() e EndOfYear(). Aggiornate le descrizioni di alcune funzioni.

2024.12.15 - v.1.35 : Ottimizzata la funzione GetNthWeekdayInYearMonth().

2024.12.18 - v.1.40 : Aggiunte le funzioni IsCurrentXXX(), IsToday(), IsTomorrow() e IsYesterday().

2024.12.19 - v.1.45 : Ottimizzate le funzioni AddMonths() e GetNthWeekdayInYearMonth().

2024.12.20 - v.1.50 : Maggiore pulizia del codice.

2024.12.21 - v.1.55 : Calcoli semplificati in AddMonths(): sostituita la complessa logica di aggiustamento dei mesi e degli anni con un più semplice calcolo dei mesi totali.