High-Performance Time Functions (TimeUtils) - MetaTrader 5 için kütüphane

İşlev adları kendi kendini açıklayıcı olmalıdır; ayrıca TimeUtils.mqh dosyasında belirli bir işlev için kısa bir açıklama bulabilirsiniz.

//+==================================================================+
//| Bileşenlerden datetime oluşturma|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // Yıl
   const int mon,            // Ay
   const int day,            // Gün
   const int hour = 0,       // Saat
   const int min = 0,        // Dakika
   const int sec = 0         // Saniye
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // StructToTime() işlevine hızlı alternatif

//+==================================================================+
//| Break datetime To Components|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // Dönüştürülecek tarih değeri
   MqlDateTime&  dt_struct   // değerlerin benimsenmesi için yapı
   )

//+==================================================================+
//| Tarih saatinin bileşenlerini ayıklayın: Pazar, yyyy.mm.dd hh:mm:ss |
//| Get() Birimleri|
//+==================================================================+
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() Sayı|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| Week() Sayı|
//+==================================================================+
int WeekOfMonth(const datetime t, bool StartsOnMonday = false)
int WeekOfYear(const datetime t, bool StartsOnMonday = false)
int WeekIndex(datetime t, bool StartsOnMonday = false)

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

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

//+==================================================================+
//| Next() Hafta içi|
//+==================================================================+
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)

//+==================================================================+
//| Önceki() Hafta içi|
//+==================================================================+
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() Ayın Hafta İçi Günü|
//+==================================================================+
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() Birimleri|
//+==================================================================+
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() Birimleri|
//+==================================================================+
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() Birimler|
//+==================================================================+
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() Birimleri|
//+==================================================================+
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() Birimleri|
//+==================================================================+
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)

//+==================================================================+
//| Zamanı String Olarak Biçimlendirme|
//+==================================================================+
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")

Mevcut tüm zaman formatlarının listesi:

//+------------------------------------------------------------------+
//| İletilen belirteç dizesine göre biçimlendirilmiş zamanı alın. |
//| Mevcut tüm formatların listesi:|
//| Biçim Çıktı Açıklama|
//| ------ ---------------- ------------------------------------- |
//| YY 18İki basamaklı yıl |
//| YYY 2018 Dört basamaklı yıl|
//| M 1-12Ay, saat 1'de başlıyor
//| MM 01-12 Ay, 2 basamaklı |
//| MMM Jan-Dec Kısaltılmış ay adı, 3 harfli |
//| MMMM Ocak-Aralık Tam ay adı|
//| D 1-31Ayın günü |
//| DD 01-31Ayın günü, 2 basamaklı |
//| DDD Sun-Sat Haftanın gününün kısa adı |
//| DDDD Pazar-Cumartesi Haftanın gününün adı |
//| h 0-23 Saat|
//| hh 00-23 Saat, 2 basamaklı |
//| H 1-12Saat, 12 saatlik saat |
//| HH 01-12 Saat, 12 saatlik saat, 2 basamaklı |
//| m 0-59 Dakika|
//| mm 00-59 Dakika, 2 basamaklı |
//| s 0-59 İkinci|
//| ss 00-59 İkinci, 2 basamaklı |
//| A AM PM|
//| a am pm|
//+------------------------------------------------------------------+
//| Örnek formatlar:|
//| "YYY.MM.DD hh:mm" // "2024.12.08 22:05" (varsayılan) |
//| "DDD, YYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" |
//| "D MMMM YYYY, HH:mm a" // "8 Aralık 2024, 10:05 pm" |
//| "GG/AA/YYYY" // "08/12/2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : İlk sürüm.

2024.12.05 - v.1.15 : İş günleri ve ayın Nth() hafta içi günü için fonksiyonlar eklendi. DaysInMonth() fonksiyonundaki hesaplamalar optimize edildi.

2024.12.09 - v.1.20 : Zamanı iletilen belirteç dizesine göre biçimlendirmek için TimeFormat() işlevi eklendi.

2024.12.09 - v.1.25 : TimeToStructFast() fonksiyonundaki hesaplamalar optimize edildi.

2024.12.10 - v.1.30 : TimeFormat(), StartOfYear() ve EndOfYear() fonksiyonları optimize edildi. Bazı fonksiyonların açıklamaları güncellendi.

2024.12.15 - v.1.35 : GetNthWeekdayInYearMonth() fonksiyonu optimize edildi.

2024.12.18 - v.1.40 : IsCurrentXXX(), IsToday(), IsTomorrow() ve IsYesterday() fonksiyonları eklendi.

2024.12.19 - v.1.45 : AddMonths() ve GetNthWeekdayInYearMonth() fonksiyonları optimize edildi.

2024.12.20 - v.1.50 : Daha fazla kod temizliği.

2024.12.21 - v.1.55 : AddMonths() işlevindeki hesaplamalar basitleştirildi: ayları ve yılları ayarlamanın karmaşık mantığı daha basit bir toplam ay hesaplamasıyla değiştirildi.