High-Performance Time Functions (TimeUtils) - bibliothèque pour MetaTrader 5

Les noms des fonctions devraient être explicites ; vous pouvez également trouver une brève description d'une fonction spécifique dans le fichier TimeUtils.mqh.

//+==================================================================+
//| Créer une date à partir de composants|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Année
   const int mon,            // Mois
   const int day,            // Jour
   const int hour = 0,       // Heure
   const int min = 0,        // Procès-verbal
   const int sec = 0         // Secondes
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // alternative rapide à StructToTime()

//+==================================================================+
//| Rupture de l'intervalle de temps en Composants|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Valeur de la date à convertir
   MqlDateTime&  dt_struct   // structure pour l'adoption de valeurs
   )

//+==================================================================+
//| Extraire les composants de l'heure de la date : dimanche, aaaa.mm.jj hh:mm:ss |
//| Get() Unités|
//+==================================================================+
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() Nombre|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
datetime CeilToMinute(datetime t)
datetime CeilToHour(datetime t)
datetime CeilToDay(datetime t)
datetime CeilToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| Next() Jour de la semaine|
//+==================================================================+
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)

//+==================================================================+
//| Précédent() Jour de la semaine|
//+==================================================================+
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() Jour de la semaine du mois|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
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() Unités|
//+==================================================================+
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)

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

//+==================================================================+
//| Formatage du temps en chaîne|
//+==================================================================+
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")

Liste de tous les formats horaires disponibles :

//+------------------------------------------------------------------+
//| Obtenir l'heure formatée en fonction de la chaîne de caractères transmise. |
//| Liste de tous les formats disponibles :|
//| Format de sortie Description|
//| ------ ---------------- ------------------------------------- |
//| YY 18Année à deux chiffres
//| YYYY 2018 Année à quatre chiffres|
//| M 1-12Le mois, commençant à 1 |
//| MM 01-12 Le mois, 2 chiffres
//| MMM Jan-Dec Le nom du mois abrégé, 3 lettres |
//| MMMM Janvier-Décembre Le nom complet du mois|
//| D 1-31Le jour du mois |
//| DD 01-31Le jour du mois, 2 chiffres |
//| DDD Sun-Sat Nom abrégé du jour de la semaine.
//| DDDD Dimanche-Samedi Le nom du jour de la semaine |
//| h 0-23 L'heure|
//| hh 00-23 L'heure, 2 chiffres |
//| H 1-12L'heure, horloge de 12 heures |
//| HH 01-12 L'heure, horloge de 12 heures, 2 chiffres |
//| m 0-59 La minute|
//| mm 00-59 Les minutes, 2 chiffres
//| s 0-59 La seconde|
//| ss 00-59 Le second, à 2 chiffres |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Formats d'échantillons :|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05" (par défaut) |
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" |
//| "D MMMM YYYY, HH:mm a" // "8 décembre 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 : Version initiale.

2024.12.05 - v.1.15 : Ajout de fonctions pour les jours ouvrables et pour le Nième() jour de semaine du mois. Optimisation des calculs dans la fonction DaysInMonth().

2024.12.09 - v.1.20 : Ajout de la fonction TimeFormat() pour formater l'heure en fonction de la chaîne de caractères passée.

2024.12.09 - v.1.25 : Optimisation des calculs dans la fonction TimeToStructFast().

2024.12.10 - v.1.30 : Optimisation des fonctions TimeFormat(), StartOfYear() et EndOfYear(). Mise à jour des descriptions de certaines fonctions.

2024.12.15 - v.1.35 : Optimisation de la fonction GetNthWeekdayInYearMonth().

2024.12.18 - v.1.40 : Ajout des fonctions IsCurrentXXX(), IsToday(), IsTomorrow() et IsYesterday().

2024.12.19 - v.1.45 : Optimisation des fonctions AddMonths() et GetNthWeekdayInYearMonth().

2024.12.20 - v.1.50 : Nettoyage du code.

2024.12.21 - v.1.55 : Simplification des calculs dans AddMonths() : remplacement de la logique complexe d'ajustement des mois et des années par un calcul plus simple du nombre total de mois.