//+------------------------------------------------------------------+
//|                                                     advanced.mq5 |
//|                                        Copyright © 2024, Amr Ali |
//|                             https://www.mql5.com/en/users/amrali |
//+------------------------------------------------------------------+

// optionally adjust performance via #defines before #include

// enable performance mode for library
//#define TIMEUTILS_PERFORMANCE_MODE
#include "TimeUtils.mqh"

int counter = 0;

#define PRINT(A) Print((string)++counter + ". " + #A + " = ", (A))

void OnStart()
{
//+==================================================================+
//| Create datetime From Components                                  |
//+==================================================================+
   PRINT( CreateDateTime(2022, 03, 25) );

//+==================================================================+
//| Break datetime To Components                                     |
//+==================================================================+
   MqlDateTime st[1] = {};
   TimeToStructFast(TimeCurrent(), st[0]);
   ArrayPrint(st);

//+==================================================================+
//| Extract Components of datetime: Sunday, yyyy.mm.dd hh:mm:ss      |
//| Get() Units                                                      |
//+==================================================================+
   datetime t = TimeLocal();
   PRINT( t2s(t, TIME_DATE|TIME_SECONDS) );  // Formats time with the weekday name

   PRINT( GetYear(t)   );
   PRINT( GetMonth(t)  );
   PRINT( GetDay(t)    );
   PRINT( GetHour(t)   );
   PRINT( GetMinute(t) );
   PRINT( GetSecond(t) );

//+==================================================================+
//| Day() Number                                                     |
//+==================================================================+
   PRINT( DayOfWeek(t) );
   PRINT( DayOfYear(t) );
   PRINT( DayIndex(t) );

//+==================================================================+
//| Week() Number                                                    |
//+==================================================================+
   PRINT( WeekOfMonth(t) );
   PRINT( WeekOfYear(t) );
   PRINT( WeekIndex(t) );

   PRINT( WeekOfMonth(t, true) ); // StartsOnMonday = true
   PRINT( WeekOfYear(t, true) ); // StartsOnMonday = true
   PRINT( WeekIndex(t, true) ); // StartsOnMonday = true

//+==================================================================+
//| StartOf() Units                                                  |
//+==================================================================+
   PRINT( StartOfMinute(t) );
   PRINT( StartOfHour(t) );
   PRINT( StartOfDay(t) );
   PRINT( StartOfWeek(t) );
   PRINT( StartOfWeek(t, true) ); // StartsOnMonday = true
   PRINT( StartOfMonth(t) );
   PRINT( StartOfYear(t) );

//+==================================================================+
//| EndOf() Units                                                    |
//+==================================================================+
  PRINT( EndOfMinute(t) );
  PRINT( EndOfHour(t) );
  PRINT( EndOfDay(t) );
  PRINT( EndOfWeek(t) );
  PRINT( EndOfWeek(t, true) ); // StartsOnMonday = true
  PRINT( EndOfMonth(t) );
  PRINT( EndOfYear(t) );

//+==================================================================+
//| SecsElapsedOf() Units                                            |
//+==================================================================+
   PRINT( SecsElapsedOfMinute(t) );
   PRINT( SecsElapsedOfHour(t) );
   PRINT( SecsElapsedOfDay(t) );
   PRINT( SecsElapsedOfWeek(t) );
   PRINT( SecsElapsedOfWeek(t, true) ); // StartsOnMonday = true
   PRINT( SecsElapsedOfMonth(t) );
   PRINT( SecsElapsedOfYear(t) );

//+==================================================================+
//| RoundTo() / Nearest() Units                                      |
//+==================================================================+
   PRINT( RoundToMinute(t) );
   PRINT( RoundToHour(t) );
   PRINT( RoundToDay(t) );
   PRINT( RoundToWeek(t) );
   PRINT( RoundToWeek(t, true) ); // StartsOnMonday = true

//+==================================================================+
//| CeilTo() / Next() Units                                          |
//+==================================================================+
   PRINT( CeilToMinute(t) );
   PRINT( CeilToHour(t) );
   PRINT( CeilToDay(t) );
   PRINT( CeilToWeek(t) );
   PRINT( CeilToWeek(t, true) ); // StartsOnMonday = true

//+==================================================================+
//| Next() Weekday                                                   |
//+==================================================================+
   PRINT( NextSunday(t) );
   PRINT( NextMonday(t) );
   PRINT( NextTuesday(t) );
   PRINT( NextWednesday(t) );
   PRINT( NextThursday(t) );
   PRINT( NextFriday(t) );
   PRINT( NextSaturday(t) );

//+==================================================================+
//| Previous() Weekday                                               |
//+==================================================================+
   PRINT( PreviousSunday(t) );
   PRINT( PreviousMonday(t) );
   PRINT( PreviousTuesday(t) );
   PRINT( PreviousWednesday(t) );
   PRINT( PreviousThursday(t) );
   PRINT( PreviousFriday(t) );
   PRINT( PreviousSaturday(t) );

//+==================================================================+
//| Nth() Weekday Of The Month                                       |
//+==================================================================+
  PRINT( FirstWeekdayOfTheMonth(t, SUNDAY) );
  PRINT( LastWeekdayOfTheMonth(t, SUNDAY) );

//+==================================================================+
//| Add() Units                                                      |
//+==================================================================+
   PRINT( AddSeconds(t, 30) );
   PRINT( AddMinutes(t, 30) );
   PRINT( AddHours(t, 2) );
   PRINT( AddDays(t, 10) );
   PRINT( AddBusinessDays(t, 10) );
   PRINT( AddWeeks(t, 4) );
   PRINT( AddMonths(t, 2) );
   PRINT( AddYears(t, 5) );

//+==================================================================+
//| Sub() Units                                                      |
//+==================================================================+
   PRINT( SubSeconds(t, 30) );
   PRINT( SubMinutes(t, 30) );
   PRINT( SubHours(t, 2) );
   PRINT( SubDays(t, 10) );
   PRINT( SubBusinessDays(t, 10) );
   PRINT( SubWeeks(t, 4) );
   PRINT( SubMonths(t, 2) );
   PRINT( SubYears(t, 5) );

//+==================================================================+
//| DifferenceIn() Units                                             |
//+==================================================================+
   PRINT( DifferenceInCalendarDays(t, AddWeeks(t, 9)) );
   PRINT( DifferenceInBusinessDays(t, AddWeeks(t, 9)) );
   PRINT( DifferenceInCalendarWeeks(t, AddWeeks(t, 9)) );
   PRINT( DifferenceInCalendarWeeks(t, AddWeeks(t, 9), true) ); // StartsOnMonday = true
   PRINT( DifferenceInCalendarMonths(t, AddWeeks(t, 9)) );

//+==================================================================+
//| IsSame() Units                                                   |
//+==================================================================+
   PRINT( IsSameMinute(t, AddHours(t, 25)) );
   PRINT( IsSameHour(t, AddHours(t, 25)) );
   PRINT( IsSameDay(t, AddHours(t, 25)) );
   PRINT( IsSameWeek(t, AddHours(t, 25)) );
   PRINT( IsSameWeek(t, AddHours(t, 25), true) ); // StartsOnMonday = true
   PRINT( IsSameMonth(t, AddHours(t, 25)) );
   PRINT( IsSameYear(t, AddHours(t, 25)) );

//+==================================================================+
//| IsCurrent() Units                                                |
//+==================================================================+
   PRINT( IsCurrentMinute(t) );
   PRINT( IsCurrentHour(t) );
   PRINT( IsCurrentWeek(t) );
   PRINT( IsCurrentWeek(t, true) ); // StartsOnMonday = true
   PRINT( IsCurrentMonth(t) );
   PRINT( IsCurrentYear(t) );
   PRINT( IsToday(t) );
   PRINT( IsTomorrow(t) );
   PRINT( IsYesterday(t) );

//+==================================================================+
//| Misc                                                             |
//+==================================================================+
   PRINT( IsLeapYear(2100) );
   PRINT( DaysInMonth(2024, 2) );
   PRINT( GetNthWeekdayInYearMonth(2024, 1, 1, SUNDAY) );

//+==================================================================+
//| Formating Time to String                                         |
//+==================================================================+
   PRINT( t2s(TimeCurrent()) );
   PRINT( SecondsToString(SecsElapsedOfDay(TimeCurrent())) );
   PRINT( TimeFormat(TimeCurrent(), "YYYY.MM.DD hh:mm") );
   PRINT( TimeFormat(TimeCurrent(), "DDD, YYYY.MM.DD hh:mm:ss") );
   PRINT( TimeFormat(TimeCurrent(), "D MMM YYYY, HH:mm a") );

}
//+------------------------------------------------------------------+


/*
 example output:

 1. CreateDateTime(2022, 03, 25) = 2022.03.25 00:00:00
     [year] [mon] [day] [hour] [min] [sec] [day_of_week] [day_of_year]
 [0]   2024    12    18     17    27    25             3           352
 2. t2s(t, TIME_DATE|TIME_SECONDS) = Wed, 2024.12.18 18:27:25
 3. GetYear(t) = 2024
 4. GetMonth(t) = 12
 5. GetDay(t) = 18
 6. GetHour(t) = 18
 7. GetMinute(t) = 27
 8. GetSecond(t) = 25
 9. DayOfWeek(t) = 3
 10. DayOfYear(t) = 352
 11. DayIndex(t) = 20075
 12. WeekOfMonth(t) = 3
 13. WeekOfYear(t) = 51
 14. WeekIndex(t) = 2868
 15. WeekOfMonth(t, true) = 4
 16. WeekOfYear(t, true) = 51
 17. WeekIndex(t, true) = 2868
 18. StartOfMinute(t) = 2024.12.18 18:27:00
 19. StartOfHour(t) = 2024.12.18 18:00:00
 20. StartOfDay(t) = 2024.12.18 00:00:00
 21. StartOfWeek(t) = 2024.12.15 00:00:00
 22. StartOfWeek(t, true) = 2024.12.16 00:00:00
 23. StartOfMonth(t) = 2024.12.01 00:00:00
 24. StartOfYear(t) = 2024.01.01 00:00:00
 25. EndOfMinute(t) = 2024.12.18 18:27:59
 26. EndOfHour(t) = 2024.12.18 18:59:59
 27. EndOfDay(t) = 2024.12.18 23:59:59
 28. EndOfWeek(t) = 2024.12.21 23:59:59
 29. EndOfWeek(t, true) = 2024.12.22 23:59:59
 30. EndOfMonth(t) = 2024.12.31 23:59:59
 31. EndOfYear(t) = 2024.12.31 23:59:59
 32. SecsElapsedOfMinute(t) = 25
 33. SecsElapsedOfHour(t) = 1645
 34. SecsElapsedOfDay(t) = 66445
 35. SecsElapsedOfWeek(t) = 325645
 36. SecsElapsedOfWeek(t, true) = 239245
 37. SecsElapsedOfMonth(t) = 1535245
 38. SecsElapsedOfYear(t) = 30479245
 39. RoundToMinute(t) = 2024.12.18 18:27:00
 40. RoundToHour(t) = 2024.12.18 18:00:00
 41. RoundToDay(t) = 2024.12.19 00:00:00
 42. RoundToWeek(t) = 2024.12.22 00:00:00
 43. RoundToWeek(t, true) = 2024.12.16 00:00:00
 44. CeilToMinute(t) = 2024.12.18 18:28:00
 45. CeilToHour(t) = 2024.12.18 19:00:00
 46. CeilToDay(t) = 2024.12.19 00:00:00
 47. CeilToWeek(t) = 2024.12.22 00:00:00
 48. CeilToWeek(t, true) = 2024.12.23 00:00:00
 49. NextSunday(t) = 2024.12.22 00:00:00
 50. NextMonday(t) = 2024.12.23 00:00:00
 51. NextTuesday(t) = 2024.12.24 00:00:00
 52. NextWednesday(t) = 2024.12.25 00:00:00
 53. NextThursday(t) = 2024.12.19 00:00:00
 54. NextFriday(t) = 2024.12.20 00:00:00
 55. NextSaturday(t) = 2024.12.21 00:00:00
 56. PreviousSunday(t) = 2024.12.15 00:00:00
 57. PreviousMonday(t) = 2024.12.16 00:00:00
 58. PreviousTuesday(t) = 2024.12.17 00:00:00
 59. PreviousWednesday(t) = 2024.12.11 00:00:00
 60. PreviousThursday(t) = 2024.12.12 00:00:00
 61. PreviousFriday(t) = 2024.12.13 00:00:00
 62. PreviousSaturday(t) = 2024.12.14 00:00:00
 63. FirstWeekdayOfTheMonth(t, SUNDAY) = 2024.12.01 00:00:00
 64. LastWeekdayOfTheMonth(t, SUNDAY) = 2024.12.29 00:00:00
 65. AddSeconds(t, 30) = 2024.12.18 18:27:55
 66. AddMinutes(t, 30) = 2024.12.18 18:57:25
 67. AddHours(t, 2) = 2024.12.18 20:27:25
 68. AddDays(t, 10) = 2024.12.28 18:27:25
 69. AddBusinessDays(t, 10) = 2025.01.01 18:27:25
 70. AddWeeks(t, 4) = 2025.01.15 18:27:25
 71. AddMonths(t, 2) = 2025.02.18 18:27:25
 72. AddYears(t, 5) = 2029.12.18 18:27:25
 73. SubSeconds(t, 30) = 2024.12.18 18:26:55
 74. SubMinutes(t, 30) = 2024.12.18 17:57:25
 75. SubHours(t, 2) = 2024.12.18 16:27:25
 76. SubDays(t, 10) = 2024.12.08 18:27:25
 77. SubBusinessDays(t, 10) = 2024.12.04 18:27:25
 78. SubWeeks(t, 4) = 2024.11.20 18:27:25
 79. SubMonths(t, 2) = 2024.10.18 18:27:25
 80. SubYears(t, 5) = 2019.12.18 18:27:25
 81. DifferenceInCalendarDays(t, AddWeeks(t, 9)) = 63
 82. DifferenceInBusinessDays(t, AddWeeks(t, 9)) = 45
 83. DifferenceInCalendarWeeks(t, AddWeeks(t, 9)) = 9
 84. DifferenceInCalendarWeeks(t, AddWeeks(t, 9), true) = 9
 85. DifferenceInCalendarMonths(t, AddWeeks(t, 9)) = 2
 86. IsSameMinute(t, AddHours(t, 25)) = false
 87. IsSameHour(t, AddHours(t, 25)) = false
 88. IsSameDay(t, AddHours(t, 25)) = false
 89. IsSameWeek(t, AddHours(t, 25)) = true
 90. IsSameWeek(t, AddHours(t, 25), true) = true
 91. IsSameMonth(t, AddHours(t, 25)) = true
 92. IsSameYear(t, AddHours(t, 25)) = true
 93. IsCurrentMinute(t) = false
 94. IsCurrentHour(t) = false
 95. IsCurrentWeek(t) = true
 96. IsCurrentWeek(t, true) = true
 97. IsCurrentMonth(t) = true
 98. IsCurrentYear(t) = true
 99. IsToday(t) = true
 100. IsTomorrow(t) = false
 101. IsYesterday(t) = false
 102. IsLeapYear(2100) = false
 103. DaysInMonth(2024, 2) = 29
 104. GetNthWeekdayInYearMonth(2024, 1, 1, SUNDAY) = 2024.01.07 00:00:00
 105. t2s(TimeCurrent()) = Wed, 2024.12.18 17:27
 106. SecondsToString(SecsElapsedOfDay(TimeCurrent())) = 17:27:25
 107. TimeFormat(TimeCurrent(), YYYY.MM.DD hh:mm) = 2024.12.18 17:27
 108. TimeFormat(TimeCurrent(), DDD, YYYY.MM.DD hh:mm:ss) = Wed, 2024.12.18 17:27:25
 109. TimeFormat(TimeCurrent(), D MMM YYYY, HH:mm a) = 18 Dec 2024, 05:27 pm

*/