High-Performance Time Functions (TimeUtils) - MetaTrader 5 Library - MT4/MT5 Resources

The library contains more than 80 different functions to handle time variables. The main goal is to provide high performance time functions. Performance mode is disabled by default (can be controlled at compile time via #define). This mode does not require the library to be included into your project, as it will work fine without it.

TIMEUTILS_PERFORMANCE_MODE

Optionally, performance mode can be turned on at compile time via #defines before #include:

 // Enable performance mode for the library
#Define TIMEUTILS_PERFORMANCE_MODE #Include "TimeUtils.mqh"

This redirects all calls to MQL's built-in build-time and structure-to-time functionality to more efficient alternatives.

You can compile the script "performance_mode.mq5" with or without TIMEUTILS_PERFORMANCE_MODE Check the speed differences on your machine. This will be beneficial for high-performance programs that perform heavy or many time-related tasks (for example, scanning all tick history of the H1 bar at the beginning of the trading week or collecting other statistics).

Function names should be self-explanatory; in addition, you can find a short description of a specific function in the TimeUtils.mqh file.

//+======================================================================+
//|Create date and time from component |
//+======================================================================+
DateTimeCreationDateTime (
constant integer year, // year constant integer Monday, // month constant integer day, // day constant integer hour = 0 , // hour constant integer minute = 0 , // minute constant integer second = 0 // seconds ) DateTime CreateDateTime( MqlDateTime &dt_struct); // Fast alternative to StructToTime()

//+======================================================================+
//|Decompose datetime into components |
//+======================================================================+
boolean fast structure time(
datetime det, // The date value to be converted Mql datetime & dt_struct // The structure that takes the value ) //+==================================================================+
//|Extract the components of the date and time: Sunday, yyyy.mm.dd hh:mm:ss |
//| Get() unit |
//+======================================================================+
Integer gets the second ( date time t) Integer gets the minute ( date time t) Integer gets the time ( date time t) Integer gets the day ( date time t) Integer gets the month ( date time t) Integer gets the year ( date time t) //+======================================================================+
//| Day() number |
//+======================================================================+
Integer day of the week ( date time t) Integer day of the year ( date time t) Integer day index ( date time t) //+====================================================================+
//|Week number |
//+======================================================================+
integer week of the month ( const datetime t, boolean start on Monday = false ) integer week of the year ( const datetime t, boolean start on Monday = false ) integer week index ( datetime t, boolean start on Monday = false ) //+==================================================================+
//| StartOf() unit |
//+======================================================================+
datetime start of minute ( datetime t) datetime start of time ( datetime t) datetime start of day ( datetime t) datetime start of week ( datetime t, boolean>starts on monday=Wrong）date timethe beginning of the month（date timet）date timeBeginning of the year（date timet） //+====================================================================+ //| EndOf() unit                                                    | //+========================================================================+ datetime minute end ( datetime t) datetime endtime ( datetime t) datetime end of day ( datetime t) datetime end of week ( datetime t, boolean Monday start = false ) datetime end of month ( datetime t) datetime end of year ( datetime t) //+====================================================================+ //| SecsElapsedOf() unit | //+========================================================================+ Integer minutes seconds elapsed ( datetime t) Integer seconds elapsed ( datetime t) Integer days elapsed seconds ( datetime t) Integer weeks elapsed seconds ( datetime t, boolean Monday start = false ) Integer months elapsed seconds ( datetime t) Integer years elapsed seconds ( datetime t) //+======================================================================+ //| RoundTo() / Nearest() Unit | //+========================================================================+ datetime round to minute ( datetime t) datetime round to hour (datetime t) datetime round to hour ( datetime t) datetime round to week ( datetime t, boolean start Monday = false ) //+======================================================================+ //| CeilTo() / Next() Unit | //+========================================================================+ datetime ceiling to minute( datetime t) datetime ceiling to hour( datetime t) datetime ceiling to day( datetime t) datetime ceiling to week( datetime t, boolean start Monday = false ) //+========================================================================+ //|Next () working day | //+====================================================================================================================================================================+ Date and time next working day ( date and time t, ENUM_DAY_OF_WEEK working day = Sunday ) date time next Sunday (date time t) date time next Monday ( date time t) date time next Tuesday ( date time t) date time next Wednesday ( date time t) date time next Thursday ( date time t) date time next Friday (date time t) date time next Saturday ( date time t) //+======================================================================+ //|Previous page() working day | //+==================================================================================+ Date time Previous working day ( date time t, ENUM_DAY_OF_WEEKworking day = Sunday ) date time last Sunday ( date time t) date time last Monday ( date time t) date time last Tuesday ( date time t) date time last Wednesday ( date time t) date time last Thursday ( date time t) date time last Friday ( date time t) date time last Saturday ( date time t) //+========================================================================================+ //|The N ( )th working day of the month | //+======================================================================+ Date and time The first working day of the month ( date and time t , ENUM_DAY_OF_WEEK working day = Sunday ) Date and time The last working day of the month ( date and time t , ENUM_DAY_OF_WEEK working day = Sunday ) Date and time The Nth working day of this month ( Date and time t, integer Nth, ENUM_DAY_OF_WEEK working day = Sunday) //+========================================================================+ //| Add() unit | // +======================================================================+ datetime add seconds ( datetime t, integer number) datetime add minutes ( datetime t, integer number) datetime add time ( date time t , integer quantity) date time add days ( date time t, integer quantity) date time add weekdays ( date time t, integer quantity) date time add week number ( date time t, integer quantity) date time add month ( date time t, integer quantity) date time add year ( date time t, integer quantity) //+======================================================================+ //| Sub() Unit | //+======================================================================+ datetime subsecond ( datetime t, integer number) datetime subminute ( datetime t, integer number) date time less than hours ( datetime t, integer quantity) datetime subday ( datetime t, integer quantity) datetime subbusiness day (datetime t, integer quantity) datetime subweek ( datetime t, integer quantity) datetime submonth ( datetime t, integer quantity ) datetime subyear ( datetime t, integer quantity ) //+======================================================================+ //| DifferenceIn() unit | //+======================================================================+ Integer calendar day difference( datetime start time, date time end time) integer calendar week difference( date time start time, date time end time) integer calendar week difference(date time start time, date time end time, boolean Monday start = false ) integer calendar month difference( date time start time, date time end time)ment">//+====================================================================+ //| IsSame() unit | //+====================================================================+ The Boolean value is the same minute ( date time t1, date time t2) The Boolean value is the same time ( date time Between t1, date time t2) Boolean value is the same day ( date time t1, date time t2) Boolean value is the same week ( date time t1, date time t2, boolean value starts on Monday = false ) Boolean value is the same month (date time t1, date time t2) Boolean value is the same year ( date time t1, date time t2) //+======================================================================+ //| IsCurrent() Unit | //+====================================================================+ The Boolean value is the current minute ( date time t) The Boolean value is the current time ( date time t) time t) boolean is the current week ( date time t, boolean Monday starts = false ) boolean is the current month ( date time t) boolean is the current year ( date time t) boolean is today (date time t) boolean is tomorrow ( date time t) boolean is yesterday ( date time t) //+======================================================================+ //|Others | //+======================================================================+ The Boolean value is a leap year ( integer year) integer number of days in a month ( integer year , integer month) date and time GetNthWeekdayInYearMonth (iYear, iMonth, Nth, weekday = Sunday ) date and time GetNthSundayInYearMonth (iYear, iMonth, Nth) //+============================================================================+ //| Format time as a string | //+============================================================================================+ string t2s(datetime t, const integer mode = TIME_DATE | TIME_MINUTES ) string seconds to string ( integer seconds) string time format ( date time t, string format = "year.month.day:minute" )

//+------------------------------------------------------------------+
//|Get the formatting time based on the passed token string. |
//|List of all available formats: |
//|Format Output Description |
//| ------- ---------------- ------------------------------------------------------------------ |
//| YY 18 two-digit year |
//| YYYY 2018 four-digit year |
//| M January-December, starting from 1 |
//| MM 01-December, 2 digits |
//| MMM Jan-Dec Month abbreviation, 3 letters |
//| MMMM January to December Full month name |
//| D 1-31 One day in January |
//| DD 01-31 day in month, 2 digits |
//| DDD Sunday to Saturday Abbreviation of a day of the week |
//| DDDD Sunday to Saturday The name of the day of the week |
//| h 0-23 hours |
//| hh 00-23 hours, 2 digits |
//| H 1-12 hours, 12-hour clock |
//| HH 01-12 hours, 12-hour clock, 2 digits |
//| m 0-59 minutes |
//| mm 00-59 minutes, 2 digits |
//| s 0-59 second |
//| ss 00-59 second 2-digit number |
//| A AM PM |
//| a morning |
//+------------------------------------------------------------------+
//|Example format: |
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05" (default) |
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sunday, 2024.12.08 22:05:21" |
//| "D MMMM YYYY, HH:mm a" // "December 8, 2024, 10:05 pm" |
//| "DD/MM/YYYY" // "08/12/2024" |
//+------------------------------------------------------------------+
String time format ( constant date time t, constant string format = "year.month.day:hour:minute" );