High-Performance Time Functions (TimeUtils) - Bibliothek für den MetaTrader 5

Die Funktionsnamen sollten selbsterklärend sein; außerdem finden Sie eine kurze Beschreibung für eine bestimmte Funktion in der Datei TimeUtils.mqh.

//+==================================================================+
//| Datetime aus Komponenten erstellen|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Jahr
   const int mon,            // Monat
   const int day,            // Tag
   const int hour = 0,       // Stunde
   const int min = 0,        // Minuten
   const int sec = 0         // Sekunden
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // schnelle Alternative zu StructToTime()

//+==================================================================+
//| Break datetime To Components|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Zu konvertierender Datumswert
   MqlDateTime&  dt_struct   // Struktur für die Übernahme von Werten
   )

//+==================================================================+
//| Komponenten von datetime extrahieren: Sonntag, jjjj.mm.tt 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)

//+==================================================================+
//| Tag() Zahl|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| Woche() Zahl|
//+==================================================================+
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() Einheiten|
//+==================================================================+
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() Einheiten|
//+==================================================================+
datetime CeilToMinute(datetime t)
datetime CeilToHour(datetime t)
datetime CeilToDay(datetime t)
datetime CeilToWeek(datetime t, bool StartsOnMonday = false)

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

//+==================================================================+
//| Vorheriger() Wochentag|
//+==================================================================+
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() Wochentag des Monats|
//+==================================================================+
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() Einheiten|
//+==================================================================+
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)

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

//+==================================================================+
//| Zeit in String umwandeln|
//+==================================================================+
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 aller verfügbaren Zeitformate:

//+------------------------------------------------------------------+
//| Ermittelt die formatierte Zeit entsprechend der übergebenen Zeichenkette. |
//| Liste aller verfügbaren Formate:|
//| Format Ausgabe Beschreibung|
//| ------ ---------------- ------------------------------------- |
//| JJ 18Zweistelliges Jahr |
//| JJJJ 2018 Vierstelliges Jahr|
//| M 1-12Der Monat, beginnend mit 1 |
//| MM 01-12 Der Monat, 2-stellig |
//| MMM Jan-Dez Der abgekürzte Monatsname, 3-Buchstaben |
//| MMMM Januar-Dezember Der vollständige Monatsname|
//| D 1-31Der Tag des Monats |
//| DD 01-31Der Tag des Monats, 2-stellig |
//| DDD Sun-Sat Die Kurzbezeichnung des Wochentags |
//| DDDD Sonntag-Samstag Der Name des Wochentags |
//| h 0-23 Die Stunde|
//| hh 00-23 Die Stunde, 2-stellig |
//| H 1-12Die Stunde, 12-Stunden-Uhr |
//| HH 01-12 Die Stunde, 12-Stunden-Uhr, 2-stellig |
//| m 0-59 Die Minute|
//| mm 00-59 Die Minute, zweistellig |
//| s 0-59 Die Sekunde|
//| ss 00-59 Die zweite, 2-stellige |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Beispielformate:|
//| "JJJJ.MM.TT hh:mm" // "2024.12.08 22:05" (Standard) |
//| "TTT, JJJJ.MM.TT hh:mm:ss" // "So, 2024.12.08 22:05:21" |
//| "D MMMM JJJJ, HH:mm a" // "8. Dezember 2024, 22:05 Uhr" |
//| "TT/MM/JJJJ" // "12.08.2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : Erste Veröffentlichung.

2024.12.05 - v.1.15 : Funktionen für Arbeitstage und für den N-ten() Wochentag des Monats hinzugefügt. Optimierte Berechnungen in der DaysInMonth() Funktion.

2024.12.09 - v.1.20 : Funktion TimeFormat() hinzugefügt, um die Zeit entsprechend der übergebenen Zeichenkette zu formatieren.

2024.12.09 - v.1.25 : Optimierte Berechnungen in der Funktion TimeToStructFast().

2024.12.10 - v.1.30 : Optimierte TimeFormat(), StartOfYear() und EndOfYear() Funktionen. Aktualisierte Beschreibungen von einigen Funktionen.

2024.12.15 - v.1.35 : Optimierte Funktion GetNthWeekdayInYearMonth().

2024.12.18 - v.1.40 : IsCurrentXXX(), IsToday(), IsTomorrow() und IsYesterday() Funktionen hinzugefügt.

2024.12.19 - v.1.45 : Optimierte AddMonths() und GetNthWeekdayInYearMonth() Funktionen.

2024.12.20 - v.1.50 : Weitere Codebereinigung.

2024.12.21 - v.1.55 : Vereinfachte Berechnungen in AddMonths(): Die komplexe Logik der Anpassung von Monaten und Jahren wurde durch eine einfachere Berechnung der Gesamtmonate ersetzt.