Utility functions for converting between time units. More...

Topics
	Time Zone Conversions
	Helpers for converting regional time zones to GMT.

	Time structure conversions

Functions
int	time_shield::ns_of_sec (double ts)
	Get the nanosecond part of a floating-point timestamp.

int	time_shield::us_of_sec (double ts)
	Get the microsecond part of a floating-point timestamp.

int	time_shield::ms_of_sec (double ts)
	Get the millisecond part of a floating-point timestamp.

int	time_shield::ms_of_ts (long ts_ms)
	Get the millisecond part of a millisecond timestamp.

long	time_shield::sec_to_ms (double sec)
	Convert seconds to milliseconds.

long	time_shield::ms_to_sec (long ms)
	Convert milliseconds to seconds (integer part).

double	time_shield::ms_to_fsec (long ms)
	Convert milliseconds to floating-point seconds.

long	time_shield::min_to_ms (double min)
	Convert minutes to milliseconds.

int	time_shield::ms_to_min (long ms)
	Convert milliseconds to minutes (integer part).

long	time_shield::min_to_sec (double min)
	Convert minutes to seconds.

int	time_shield::sec_to_min (long sec)
	Convert seconds to minutes (integer part).

double	time_shield::min_to_fsec (double min)
	Convert minutes to floating-point seconds.

double	time_shield::sec_to_fmin (long sec)
	Convert seconds to floating-point minutes.

long	time_shield::hour_to_ms (double hr)
	Convert hours to milliseconds.

int	time_shield::ms_to_hour (long ms)
	Convert milliseconds to hours (integer part).

long	time_shield::hour_to_sec (double hr)
	Convert hours to seconds.

int	time_shield::sec_to_hour (long sec)
	Convert seconds to hours (integer part).

double	time_shield::hour_to_fsec (double hr)
	Convert hours to floating-point seconds.

double	time_shield::sec_to_fhour (long sec)
	Convert seconds to floating-point hours.

int	time_shield::hour24_to_12 (int hour)
	Convert a 24-hour format hour to a 12-hour format.

int	time_shield::h24_to_h12 (int hour)
	Alias for hour24_to_12.

long	time_shield::get_unix_year (long ts)
	Convert a UNIX timestamp to a year.

long	time_shield::unix_year (long ts)
	Alias for get_unix_year function.

long	time_shield::to_unix_year (long ts)
	Alias for get_unix_year function.

long	time_shield::get_year (long ts)
	Get the year from a timestamp.

long	time_shield::year (long ts)
	Alias for get_year.

long	time_shield::to_year (long ts)
	Alias for get_year.

long	time_shield::get_year_ms (long ts_ms)
	Get the year from a millisecond timestamp.

long	time_shield::year_ms (long ts_ms)
	Alias for get_year_ms.

long	time_shield::to_year_ms (long ts_ms)
	Alias for get_year_ms.

DateTimeStruct	time_shield::to_date_time (long ts)
	Convert a timestamp to a DateTimeStruct.

DateTimeStruct	time_shield::to_dt (long ts)
	Alias for to_date_time.

MqlDateTime	time_shield::to_date_time_mql (long ts)
	Convert a timestamp to the standard MqlDateTime structure.

MqlDateTime	time_shield::to_mql_dt (long ts)
	Alias for to_date_time_mql.

DateTimeStruct	time_shield::to_date_time_ms (long ts_ms)
	Convert a timestamp in milliseconds to DateTimeStruct.

DateTimeStruct	time_shield::to_dt_ms (long ts_ms)
	Alias for to_date_time_ms.

long	time_shield::dt_to_timestamp (const DateTimeStruct &dt)
	Convert a DateTimeStruct to timestamp.

long	time_shield::dt_to_timestamp (const MqlDateTime &dt)
	Convert an MqlDateTime structure to timestamp.

long	time_shield::to_timestamp (const DateTimeStruct &dt)
	Alias for dt_to_timestamp.

long	time_shield::to_timestamp (const MqlDateTime &dt)
	Alias for dt_to_timestamp taking MqlDateTime.

long	time_shield::to_timestamp (long year, int mon, int day, int hour=0, int min=0, int sec=0)
	Convert date and time values to a timestamp.

long	time_shield::to_ts (long year, int mon, int day, int hour=0, int min=0, int sec=0)
	Alias for to_timestamp with explicit date fields.

long	time_shield::to_timestamp_ms (long year, int mon, int day, int hour=0, int min=0, int sec=0, int ms=0)
	Convert date and time values to a timestamp in milliseconds.

long	time_shield::to_ts_ms (long year, int mon, int day, int hour=0, int min=0, int sec=0, int ms=0)
	Alias for to_timestamp_ms.

long	time_shield::ts_ms (long year, int mon, int day, int hour=0, int min=0, int sec=0, int ms=0)
	Alias for to_timestamp_ms.

long	time_shield::dt_to_timestamp_ms (const DateTimeStruct &dt)
	Convert a DateTimeStruct to a timestamp in milliseconds.

long	time_shield::dt_to_timestamp_ms (const MqlDateTime &dt)
	Convert an MqlDateTime structure to a timestamp in milliseconds.

long	time_shield::to_timestamp_ms (const DateTimeStruct &dt)
	Alias for dt_to_timestamp_ms.

long	time_shield::to_timestamp_ms (const MqlDateTime &dt)
	Alias for dt_to_timestamp_ms.

double	time_shield::dt_to_ftimestamp (const DateTimeStruct &dt)
	Convert a DateTimeStruct to floating-point timestamp.

double	time_shield::dt_to_ftimestamp (const MqlDateTime &dt)
	Convert an MqlDateTime structure to floating-point timestamp.

double	time_shield::to_ftimestamp (const DateTimeStruct &dt)
	Alias for dt_to_ftimestamp.

double	time_shield::to_ftimestamp (const MqlDateTime &dt)
	Alias for dt_to_ftimestamp.

long	time_shield::start_of_day (long ts)
	Get the start of the day for a timestamp.

long	time_shield::day_start (long ts)
	Alias for start_of_day.

long	time_shield::start_of_prev_day (long ts, int days=1)
	Get the start of the previous day.

long	time_shield::previous_day_start (long ts, int days=1)
	Alias for start_of_prev_day.

long	time_shield::start_of_day_sec (long ts_ms)
	Get the start of the day in seconds from milliseconds timestamp.

long	time_shield::day_start_sec (long ts_ms)
	Alias for start_of_day_sec.

long	time_shield::start_of_day_ms (long ts_ms)
	Get the start of the day for a millisecond timestamp.

long	time_shield::day_start_ms (long ts_ms)
	Alias for start_of_day_ms.

long	time_shield::start_of_next_day (long ts, int days=1)
	Get the start of the next day.

long	time_shield::next_day_start (long ts, int days=1)
	Alias for start_of_next_day.

long	time_shield::start_of_next_day_ms (long ts_ms, int days=1)
	Get the start of the next day in milliseconds.

long	time_shield::next_day_start_ms (long ts_ms, int days=1)
	Alias for start_of_next_day_ms.

long	time_shield::next_day (long ts, int days=1)
	Add days to a timestamp without adjusting to start of day.

long	time_shield::next_day_ms (long ts_ms, int days=1)
	Add days to a millisecond timestamp without adjusting to start of day.

long	time_shield::end_of_day (long ts)
	Get the end of the day for a timestamp.

long	time_shield::day_end (long ts)
	Alias for end_of_day.

long	time_shield::end_of_day_sec (long ts_ms)
	Get the end of the day in seconds from milliseconds timestamp.

long	time_shield::day_end_sec (long ts_ms)
	Alias for end_of_day_sec.

long	time_shield::end_of_day_ms (long ts_ms)
	Get the end of the day for a millisecond timestamp.

long	time_shield::day_end_ms (long ts_ms)
	Alias for end_of_day_ms.

Weekday	time_shield::day_of_week_date (long year, int month, int day)
	Get the day of the week for a date.

Weekday	time_shield::get_weekday (long year, int month, int day)
	Alias for day_of_week_date.

Weekday	time_shield::day_of_week (long year, int month, int day)
	Alias for day_of_week_date.

Weekday	time_shield::get_weekday_from_date (const DateTimeStruct &dt)
	Get weekday from a DateTimeStruct.

Weekday	time_shield::get_weekday_from_date (const MqlDateTime &dt)
	Get weekday from a MqlDateTime structure.

Weekday	time_shield::day_of_week_dt (const DateTimeStruct &dt)
	Alias for get_weekday_from_date with DateTimeStruct.

Weekday	time_shield::day_of_week (const DateTimeStruct &dt)
	Alias for get_weekday_from_date with DateTimeStruct.

Weekday	time_shield::day_of_week_dt (const MqlDateTime &dt)
	Alias for get_weekday_from_date with MqlDateTime.

Weekday	time_shield::day_of_week (const MqlDateTime &dt)
	Alias for get_weekday_from_date with MqlDateTime.

Weekday	time_shield::get_weekday_from_ts (long ts)
	Get weekday from timestamp.

Weekday	time_shield::day_of_week (long ts)
	Alias for get_weekday_from_ts.

Weekday	time_shield::get_weekday_from_ts_ms (long ts_ms)
	Get weekday from millisecond timestamp.

Weekday	time_shield::day_of_week_ms (long ts_ms)
	Alias for get_weekday_from_ts_ms.

long	time_shield::start_of_year (long ts)
	Get the start of the year for a timestamp.

long	time_shield::end_of_year (long ts)
	Get the end of the year for a timestamp.

long	time_shield::year_start (long ts)
	Alias for start_of_year.

long	time_shield::year_begin (long ts)
	Alias for start_of_year.

long	time_shield::start_of_year_ms (long ts_ms)
	Get the start of the year in milliseconds.

long	time_shield::year_start_ms (long ts_ms)
	Alias for start_of_year_ms.

long	time_shield::year_begin_ms (long ts_ms)
	Alias for start_of_year_ms.

long	time_shield::start_of_year_date (long year)
	Get the timestamp for the start of the specified year.

long	time_shield::year_start_date (long year)
	Alias for start_of_year_date.

long	time_shield::year_begin_date (long year)
	Alias for start_of_year_date.

long	time_shield::start_of_year_date_ms (long year)
	Get the timestamp in milliseconds for the start of the specified year.

long	time_shield::year_start_date_ms (long year)
	Alias for start_of_year_date_ms.

long	time_shield::year_begin_date_ms (long year)
	Alias for start_of_year_date_ms.

long	time_shield::end_of_year_ms (long ts_ms)
	Get the end of the year in milliseconds.

long	time_shield::year_end_ms (long ts_ms)
	Alias for end_of_year_ms.

int	time_shield::day_of_year (long ts)
	Get the day of the year.

Month	time_shield::month_of_year (long ts)
	Get the month of the year.

int	time_shield::day_of_month (long ts)
	Get the day of the month.

int	time_shield::num_days_in_month (long year, int month)
	Get the number of days in a month.

int	time_shield::days_in_month (long year, int month)
	Alias for num_days_in_month.

int	time_shield::num_days_in_month_ts (long ts)
	Get the number of days in the month of a timestamp.

int	time_shield::num_days_in_month (long ts)
	Alias for num_days_in_month_ts.

int	time_shield::days_in_month (long ts)
	Alias for num_days_in_month_ts.

int	time_shield::num_days_in_year (long year)
	Get number of days in a year.

int	time_shield::days_in_year (long year)
	Alias for num_days_in_year.

int	time_shield::num_days_in_year_ts (long ts)
	Get number of days in the year of the timestamp.

int	time_shield::days_in_year_ts (long ts)
	Alias for num_days_in_year_ts.

long	time_shield::start_of_month (long ts)
	Get the timestamp at the start of the month.

long	time_shield::month_begin (long ts)
	Alias for start_of_month.

long	time_shield::end_of_month (long ts)
	Get the timestamp at the end of the month.

long	time_shield::last_day_of_month (long ts)
	Alias for end_of_month.

long	time_shield::last_sunday_of_month (long ts)
	Get the timestamp of the last Sunday of the month.

long	time_shield::final_sunday_of_month (long ts)
	Alias for last_sunday_of_month.

int	time_shield::last_sunday_month_day (long year, int month)
	Get the day of the last Sunday for the given month and year.

int	time_shield::final_sunday_month_day (long year, int month)
	Alias for last_sunday_month_day.

long	time_shield::start_of_hour (long ts)
	Get the start of the hour for a timestamp.

long	time_shield::hour_begin (long ts)
	Alias for start_of_hour.

long	time_shield::start_of_hour_sec (long ts_ms)
	Get the start of the hour in seconds from milliseconds timestamp.

long	time_shield::hour_begin_sec (long ts_ms)
	Alias for start_of_hour_sec.

long	time_shield::start_of_hour_ms (long ts_ms)
	Get the start of the hour for a millisecond timestamp.

long	time_shield::hour_begin_ms (long ts_ms)
	Alias for start_of_hour_ms.

long	time_shield::end_of_hour (long ts)
	Get the end of the hour for a timestamp.

long	time_shield::finish_of_hour (long ts)
	Alias for end_of_hour.

long	time_shield::end_of_hour_sec (long ts_ms)
	Get the end of the hour in seconds from milliseconds timestamp.

long	time_shield::finish_of_hour_sec (long ts_ms)
	Alias for end_of_hour_sec.

long	time_shield::end_of_hour_ms (long ts_ms)
	Get the end of the hour for a millisecond timestamp.

long	time_shield::finish_of_hour_ms (long ts_ms)
	Alias for end_of_hour_ms.

int	time_shield::hour_of_day (long ts)
	Get the hour of the day.

int	time_shield::hour_in_day (long ts)
	Alias for hour_of_day.

long	time_shield::start_of_week (long ts)
	Get the start of the week (Sunday).

long	time_shield::week_begin (long ts)
	Alias for start_of_week.

long	time_shield::end_of_week (long ts)
	Get the end of the week (Saturday end).

long	time_shield::finish_of_week (long ts)
	Alias for end_of_week.

long	time_shield::start_of_saturday (long ts)
	Get the start of Saturday for the week of the timestamp.

long	time_shield::saturday_begin (long ts)
	Alias for start_of_saturday.

long	time_shield::start_of_min (long ts)
	Get the start of the minute for a timestamp.

long	time_shield::min_begin (long ts)
	Alias for start_of_min.

long	time_shield::end_of_min (long ts)
	Get the end of the minute for a timestamp.

long	time_shield::finish_of_min (long ts)
	Alias for end_of_min.

int	time_shield::min_of_day (long ts)
	Get the minute of the day.

int	time_shield::min_of_hour (long ts)
	Get the minute of the hour.

int	time_shield::min_in_hour (long ts)
	Alias for min_of_hour.

long	time_shield::start_of_period (int p, long ts)
	Get the start of a period.

long	time_shield::end_of_period (int p, long ts)
	Get the end of a period.

long	time_shield::get_unix_day (long ts)
	Get UNIX day from timestamp.

long	time_shield::unix_day (long ts)
	Alias for get_unix_day.

long	time_shield::get_unixday (long ts)
	Alias for get_unix_day.

long	time_shield::unixday (long ts)
	Alias for get_unix_day.

long	time_shield::uday (long ts)
	Alias for get_unix_day.

int	time_shield::get_days_difference (long start, long stop)
	Get number of days between two timestamps.

int	time_shield::get_days (long start, long stop)
	Alias for get_days_difference.

int	time_shield::days (long start, long stop)
	Alias for get_days_difference.

long	time_shield::get_unix_day_ms (long ts_ms)
	Get UNIX day from milliseconds timestamp.

long	time_shield::unix_day_ms (long ts_ms)
	Alias for get_unix_day_ms.

long	time_shield::get_unixday_ms (long ts_ms)
	Alias for get_unix_day_ms.

long	time_shield::unixday_ms (long ts_ms)
	Alias for get_unix_day_ms.

long	time_shield::uday_ms (long ts_ms)
	Alias for get_unix_day_ms.

long	time_shield::unix_day_to_timestamp (long uday)
	Convert UNIX day to timestamp in seconds.

long	time_shield::unix_day_to_ts (long uday)
	Alias for unix_day_to_timestamp.

long	time_shield::unixday_to_ts (long uday)
	Alias for unix_day_to_timestamp.

long	time_shield::uday_to_ts (long uday)
	Alias for unix_day_to_timestamp.

long	time_shield::start_of_day_from_unix_day (long uday)
	Alias for unix_day_to_timestamp.

long	time_shield::unix_day_to_timestamp_ms (long uday)
	Convert UNIX day to timestamp in milliseconds.

long	time_shield::unix_day_to_ts_ms (long uday)
	Alias for unix_day_to_timestamp_ms.

long	time_shield::unixday_to_ts_ms (long uday)
	Alias for unix_day_to_timestamp_ms.

long	time_shield::uday_to_ts_ms (long uday)
	Alias for unix_day_to_timestamp_ms.

long	time_shield::start_of_day_from_unix_day_ms (long uday)
	Alias for unix_day_to_timestamp_ms.

long	time_shield::end_of_day_from_unix_day (long uday)
	Get end of day timestamp from UNIX day.

long	time_shield::end_of_day_from_unix_day_ms (long uday)
	Get end of day timestamp in ms from UNIX day.

long	time_shield::eod_from_unix_day (long uday)
	Alias for end_of_day_from_unix_day.

long	time_shield::eod_from_unix_day_ms (long uday)
	Alias for end_of_day_from_unix_day_ms.

long	time_shield::start_of_next_day_from_unix_day (long uday)
	Get start of next day timestamp from UNIX day.

long	time_shield::start_of_next_day_from_unix_day_ms (long uday)
	Get start of next day timestamp in ms from UNIX day.

long	time_shield::next_day_unix_day (long uday)
	Alias for start_of_next_day_from_unix_day.

long	time_shield::next_day_unixday (long uday)
	Alias for start_of_next_day_from_unix_day.

long	time_shield::next_day_unix_day_ms (long uday)
	Alias for start_of_next_day_from_unix_day_ms.

long	time_shield::next_day_unixday_ms (long uday)
	Alias for start_of_next_day_from_unix_day_ms.

long	time_shield::next_day_from_unix_day (long uday)
	Alias for start_of_next_day_from_unix_day.

long	time_shield::get_unix_min (long ts)
	Get UNIX minute from timestamp.

long	time_shield::unix_min (long ts)
	Alias for get_unix_min.

long	time_shield::to_unix_min (long ts)
	Alias for get_unix_min.

long	time_shield::umin (long ts)
	Alias for get_unix_min.

int	time_shield::sec_of_day (long ts)
	Get second of day from timestamp.

int	time_shield::sec_of_day_ms (long ts_ms)
	Get second of day from milliseconds timestamp.

int	time_shield::sec_of_day (int hour, int min, int sec)
	Get second of day from hours, minutes and seconds.

TimeZoneStruct	time_shield::to_time_zone (int offset)
	Convert an integer offset to a TimeZoneStruct.

TimeZoneStruct	time_shield::to_tz_struct (int offset)
	Alias for to_time_zone.

datetime	time_shield::cet_to_gmt (const datetime cet)
	Convert Central European Time to Greenwich Mean Time.

datetime	time_shield::eet_to_gmt (const datetime eet)
	Convert Eastern European Time to Greenwich Mean Time.

template<class T = year_t>
constexpr T	time_shield::unix_year (ts_t ts) noexcept
	Alias for get_unix_year function.

template<class T = year_t>
constexpr T	time_shield::to_unix_year (ts_t ts) noexcept
	Alias for get_unix_year function.

template<class T = uday_t>
constexpr T	time_shield::get_unixday (ts_t ts=time_shield::ts()) noexcept
	Alias for get_unix_day function.

template<class T = uday_t>
constexpr T	time_shield::unix_day (ts_t ts=time_shield::ts()) noexcept
	Alias for get_unix_day function.

template<class T = uday_t>
constexpr T	time_shield::unixday (ts_t ts=time_shield::ts()) noexcept
	Alias for get_unix_day function.

template<class T = uday_t>
constexpr T	time_shield::uday (ts_t ts=time_shield::ts()) noexcept
	Alias for get_unix_day function.

template<class T = uday_t>
constexpr T	time_shield::get_unixday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for get_unix_day_ms function.

template<class T = uday_t>
constexpr T	time_shield::unix_day_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for get_unix_day_ms function.

template<class T = uday_t>
constexpr T	time_shield::unixday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for get_unix_day_ms function.

template<class T = uday_t>
constexpr T	time_shield::uday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for get_unix_day_ms function.

template<class T = ts_t>
constexpr T	time_shield::unix_day_to_ts (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp function.

template<class T = ts_t>
constexpr T	time_shield::unixday_to_ts (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp function.

template<class T = ts_t>
constexpr T	time_shield::uday_to_ts (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp function.

template<class T = ts_t>
constexpr T	time_shield::start_of_day_from_unix_day (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp function.

template<class T = ts_t>
constexpr T	time_shield::unix_day_to_ts_ms (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp_ms function.

template<class T = ts_t>
constexpr T	time_shield::unixday_to_ts_ms (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp_ms function.

template<class T = ts_t>
constexpr T	time_shield::uday_to_ts_ms (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp_ms function.

template<class T = ts_t>
constexpr T	time_shield::start_of_day_from_unix_day_ms (uday_t unix_day) noexcept
	Alias for unix_day_to_timestamp_ms function.

template<class T = ts_t>
constexpr T	time_shield::next_day_from_unix_day (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day function.

template<class T = ts_t>
constexpr T	time_shield::next_day_unix_day (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day function.

template<class T = ts_t>
constexpr T	time_shield::next_day_unixday (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day function.

template<class T = ts_ms_t>
constexpr T	time_shield::next_day_from_unix_day_ms (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day_ms function.

template<class T = ts_ms_t>
constexpr T	time_shield::next_day_unix_day_ms (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day_ms function.

template<class T = ts_ms_t>
constexpr T	time_shield::next_day_unixday_ms (uday_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day_ms function.

template<class T = int64_t>
constexpr T	time_shield::unix_min (ts_t ts=time_shield::ts())
	Alias for get_unix_min function.

template<class T = int64_t>
constexpr T	time_shield::to_unix_min (ts_t ts=time_shield::ts())
	Alias for get_unix_min function.

template<class T = int64_t>
constexpr T	time_shield::umin (ts_t ts=time_shield::ts())
	Alias for get_unix_min function.

template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::h24_to_h12 (T hour) noexcept
	Alias for hour24_to_12 function.

template<class T1, class T2 = ts_t>
T1	time_shield::to_dt (T2 ts)
	Alias for to_date_time function.

template<class T1, class T2 = ts_t>
T1	time_shield::to_dt_struct (T2 ts)
	Alias for to_date_time function.

template<class T>
T	time_shield::to_dt_ms (ts_ms_t ts)
	Alias for to_date_time_ms function.

template<class T>
T	time_shield::to_dt_struct_ms (ts_ms_t ts)
	Alias for to_date_time_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (year_t year, int month, int day)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (year_t year, int month, int day, int hour)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_ts (year_t year, int month, int day)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_ts (year_t year, int month, int day, int hour)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_ts (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_ts (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_timestamp (year_t year, int month, int day)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_timestamp (year_t year, int month, int day, int hour)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_timestamp (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_timestamp (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (year_t year, int month, int day)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (year_t year, int month, int day, int hour)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (year_t year, int month, int day)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (year_t year, int month, int day, int hour)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_timestamp (const T &date_time)
	Alias for dt_to_timestamp function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (const T &date_time)
	Alias for dt_to_timestamp function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (const T &date_time)
	Alias for dt_to_timestamp function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (const T &date_time)
	Alias for dt_to_timestamp function.

constexpr ts_t	time_shield::ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::get_ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::get_timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::to_ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::ts_from_tm (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_t	time_shield::to_timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.

constexpr ts_ms_t	time_shield::ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour, int min, int sec, int ms)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day, int hour, int min, int sec, int ms)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day, int hour, int min, int sec, int ms)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour, int min, int sec, int ms)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day, int hour, int min, int sec)
	Alias for to_timestamp_ms.

constexpr ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day, int hour, int min, int sec, int ms)
	Alias for to_timestamp_ms.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_timestamp_ms (const T &date_time)
	Alias for dt_to_timestamp_ms function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts_ms (const T &date_time)
	Alias for dt_to_timestamp_ms function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts_ms (const T &date_time)
	Alias for dt_to_timestamp_ms function.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp_ms (const T &date_time)
	Alias for dt_to_timestamp_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_timestamp_ms (const std::tm *timeinfo)
	Alias for tm_to_timestamp_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts_ms (const std::tm *timeinfo)
	Alias for tm_to_timestamp_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts_ms (const std::tm *timeinfo)
	Alias for tm_to_timestamp_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp_ms (const std::tm *timeinfo)
	Alias for tm_to_timestamp_ms function.

template<class T1 = year_t, class T2 = int, class T3 = int>
constexpr fts_t	time_shield::to_fts (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0)
	Alias for to_ftimestamp.

template<class T1 = year_t, class T2 = int, class T3 = int>
constexpr fts_t	time_shield::fts (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0)
	Alias for to_ftimestamp.

template<class T1 = year_t, class T2 = int, class T3 = int>
constexpr fts_t	time_shield::ftimestamp (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0)
	Alias for to_ftimestamp.

template<class T>
constexpr fts_t	time_shield::to_ftimestamp (const T &date_time)
	Alias for dt_to_ftimestamp.

template<class T>
constexpr fts_t	time_shield::to_fts (const T &date_time)
	Alias for dt_to_ftimestamp.

template<class T>
constexpr fts_t	time_shield::fts (const T &date_time)
	Alias for dt_to_ftimestamp.

template<class T>
constexpr fts_t	time_shield::ftimestamp (const T &date_time)
	Alias for dt_to_ftimestamp.

constexpr fts_t	time_shield::to_ftimestamp (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.

constexpr fts_t	time_shield::to_fts (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.

constexpr fts_t	time_shield::fts (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.

constexpr fts_t	time_shield::ftimestamp (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.

template<class T = int>
constexpr T	time_shield::get_days (ts_t start, ts_t stop) noexcept
	Alias for get_days_difference function.

template<class T = int>
constexpr T	time_shield::days (ts_t start, ts_t stop) noexcept
	Alias for get_days_difference function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::year (ts_t ts=time_shield::ts())
	Alias for get_year function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::to_year (ts_t ts=time_shield::ts())
	Alias for get_year function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::year_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Alias for get_year_ms function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::to_year_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Alias for get_year_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_start (ts_t ts=time_shield::ts())
	Alias for start_of_year function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_begin (ts_t ts=time_shield::ts())
	Alias for start_of_year function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_start_ms (ts_t ts_ms=time_shield::ts_ms())
	Alias for start_of_year_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_begin_ms (ts_t ts_ms=time_shield::ts_ms())
	Alias for start_of_year_ms function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_start_date (T year)
	Alias for start_of_year_date function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_begin_date (T year)
	Alias for start_of_year_date function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::year_start_date_ms (T year)
	Alias for start_of_year_date_ms function.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::year_begin_date_ms (T year)
	Alias for start_of_year_date_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::year_end (ts_t ts=time_shield::ts())
	Alias for end_of_year function.

TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::year_end_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Alias for end_of_year_ms function.

template<class T1 = int, class T2 = year_t, class T3 = int>
constexpr T1	time_shield::days_in_month (T2 year, T3 month) noexcept
	Alias for num_days_in_month function.

template<class T1 = int>
constexpr T1	time_shield::num_days_in_month (ts_t ts=time_shield::ts()) noexcept
	Alias for num_days_in_month_ts function.

template<class T1 = int>
constexpr T1	time_shield::days_in_month (ts_t ts=time_shield::ts()) noexcept
	Alias for num_days_in_month_ts function.

template<class T1 = int, class T2 = year_t>
constexpr T1	time_shield::days_in_year (T2 year) noexcept
	Alias for num_days_in_year function.

template<class T = int>
constexpr T	time_shield::days_in_year_ts (ts_t ts=time_shield::ts())
	Alias for num_days_in_year_ts function.

constexpr ts_t	time_shield::day_start (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_day function.

template<class T = int>
constexpr ts_t	time_shield::previous_day_start (ts_t ts=time_shield::ts(), T days=1) noexcept
	Alias for start_of_prev_day function.

constexpr ts_t	time_shield::day_start_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for start_of_day_sec function.

constexpr ts_t	time_shield::start_day_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for start_of_day_sec function.

constexpr ts_ms_t	time_shield::day_start_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for start_of_day_ms function.

template<class T = int>
constexpr ts_t	time_shield::next_day_start (ts_t ts, T days=1) noexcept
	Alias for start_of_next_day function.

template<class T = int>
constexpr ts_ms_t	time_shield::next_day_start_ms (ts_ms_t ts_ms, T days=1) noexcept
	Alias for start_of_next_day_ms function.

constexpr ts_t	time_shield::day_end (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_day function.

constexpr ts_t	time_shield::day_end_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for end_of_day_sec function.

constexpr ts_ms_t	time_shield::day_end_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for end_of_day_ms function.

template<class T1 = Weekday>
constexpr T1	time_shield::day_of_week (year_t year, int month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::day_of_week (year_t year, Month month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::get_weekday (year_t year, int month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::get_weekday (year_t year, Month month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::weekday (year_t year, int month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::weekday (year_t year, Month month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::dow (year_t year, int month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday>
constexpr T1	time_shield::dow (year_t year, Month month, int day)
	Alias for day_of_week_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::get_dow (const T2 &date)
	Alias for get_weekday_from_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::dow_from_date (const T2 &date)
	Alias for get_weekday_from_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::weekday_of (const T2 &date)
	Alias for get_weekday_from_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::day_of_week_dt (const T2 &date)
	Alias for get_weekday_from_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::day_of_week (const T2 &date)
	Alias for get_weekday_from_date.

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
constexpr T1	time_shield::dow (const T2 &date)
	Alias for get_weekday_from_date.

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
constexpr T	time_shield::day_of_week (U ts) noexcept
	Alias for get_weekday_from_ts.

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
constexpr T	time_shield::dow_ts (U ts) noexcept
	Alias for get_weekday_from_ts.

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
constexpr T	time_shield::get_dow_from_ts (U ts) noexcept
	Alias for get_weekday_from_ts.

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
constexpr T	time_shield::weekday_of_ts (U ts) noexcept
	Alias for get_weekday_from_ts.

template<class T = Weekday>
constexpr T	time_shield::day_of_week_ms (ts_ms_t ts_ms)
	Alias for get_weekday_from_ts_ms function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::month_begin (ts_t ts=time_shield::ts())
	Alias for start_of_month function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::last_day_of_month (ts_t ts=time_shield::ts())
	Alias for end_of_month function.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::final_sunday_of_month (ts_t ts=time_shield::ts())
	Alias for last_sunday_of_month function.

template<class T1 = int, class T2 = year_t, class T3 = int>
TIME_SHIELD_CONSTEXPR T1	time_shield::final_sunday_month_day (T2 year, T3 month)
	Alias for last_sunday_month_day function.

constexpr ts_t	time_shield::hour_begin (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_hour function.

constexpr ts_t	time_shield::hour_begin_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for start_of_hour_sec function.

constexpr ts_ms_t	time_shield::hour_begin_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for start_of_hour_ms function.

constexpr ts_t	time_shield::finish_of_hour (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_hour function.

constexpr ts_t	time_shield::finish_of_hour_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for end_of_hour_sec function.

constexpr ts_ms_t	time_shield::finish_of_hour_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Alias for end_of_hour_ms function.

template<class T = int>
constexpr T	time_shield::hour_in_day (ts_t ts=time_shield::ts()) noexcept
	Alias for hour_of_day function.

constexpr ts_t	time_shield::week_begin (ts_t ts=time_shield::ts())
	Alias for start_of_week function.

constexpr ts_t	time_shield::finish_of_week (ts_t ts=time_shield::ts())
	Alias for end_of_week function.

constexpr ts_t	time_shield::saturday_begin (ts_t ts=time_shield::ts())
	Alias for start_of_saturday function.

constexpr ts_t	time_shield::min_begin (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_min function.

constexpr ts_t	time_shield::finish_of_min (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_min function.

template<class T = int>
constexpr T	time_shield::ns_of_sec (fts_t ts) noexcept
	Get the nanosecond part of the second from a floating-point timestamp.

template<class T = int>
constexpr T	time_shield::us_of_sec (fts_t ts) noexcept
	Get the microsecond part of the second from a floating-point timestamp.

template<class T = int>
constexpr T	time_shield::ms_of_sec (fts_t ts) noexcept
	Get the millisecond part of the second from a floating-point timestamp.

template<class T = int>
constexpr T	time_shield::ms_of_ts (ts_ms_t ts) noexcept
	Get the millisecond part of the timestamp.

template<class T>
constexpr ts_ms_t	time_shield::sec_to_ms_impl (T t, std::true_type tag) noexcept
	Helper function for converting seconds to milliseconds (floating-point version).

template<class T>
constexpr ts_ms_t	time_shield::sec_to_ms_impl (T t, std::false_type tag) noexcept
	Helper function for converting seconds to milliseconds (integral version).

template<class T1 = ts_ms_t, class T2>
constexpr T1	time_shield::sec_to_ms (T2 ts) noexcept
	Converts a timestamp from seconds to milliseconds.

ts_ms_t	time_shield::fsec_to_ms (fts_t ts) noexcept
	Converts a floating-point timestamp from seconds to milliseconds.

template<class T1 = ts_t, class T2 = ts_ms_t>
constexpr T1	time_shield::ms_to_sec (T2 ts_ms) noexcept
	Converts a timestamp from milliseconds to seconds.

template<class T = ts_ms_t>
constexpr fts_t	time_shield::ms_to_fsec (T ts_ms) noexcept
	Converts a timestamp from milliseconds to floating-point seconds.

template<class T>
constexpr ts_ms_t	time_shield::min_to_ms_impl (T t, std::true_type tag) noexcept
	Helper function for converting minutes to milliseconds (floating-point version).

template<class T>
constexpr ts_ms_t	time_shield::min_to_ms_impl (T t, std::false_type tag) noexcept
	Helper function for converting minutes to milliseconds (integral version).

template<class T1 = ts_ms_t, class T2>
constexpr T1	time_shield::min_to_ms (T2 ts) noexcept
	Converts a timestamp from minutes to milliseconds.

template<class T1 = int, class T2 = ts_ms_t>
constexpr T1	time_shield::ms_to_min (T2 ts) noexcept
	Converts a timestamp from milliseconds to minutes.

template<class T>
constexpr ts_t	time_shield::min_to_sec_impl (T t, std::true_type tag) noexcept
	Helper function for converting minutes to seconds (floating-point version).

template<class T>
constexpr ts_t	time_shield::min_to_sec_impl (T t, std::false_type tag) noexcept
	Helper function for converting minutes to seconds (integral version).

template<class T1 = ts_t, class T2>
constexpr T1	time_shield::min_to_sec (T2 ts) noexcept
	Converts a timestamp from minutes to seconds.

template<class T1 = int, class T2 = ts_t>
constexpr T1	time_shield::sec_to_min (T2 ts) noexcept
	Converts a timestamp from seconds to minutes.

template<class T = int>
constexpr fts_t	time_shield::min_to_fsec (T min) noexcept
	Converts a timestamp from minutes to floating-point seconds.

template<class T = ts_t>
constexpr double	time_shield::sec_to_fmin (T ts) noexcept
	Converts a timestamp from seconds to floating-point minutes.

template<class T>
constexpr ts_ms_t	time_shield::hour_to_ms_impl (T t, std::true_type tag) noexcept
	Helper function for converting hours to milliseconds (floating-point version).

template<class T>
constexpr ts_ms_t	time_shield::hour_to_ms_impl (T t, std::false_type tag) noexcept
	Helper function for converting hours to milliseconds (integral version).

template<class T1 = ts_ms_t, class T2>
constexpr T1	time_shield::hour_to_ms (T2 ts) noexcept
	Converts a timestamp from hours to milliseconds.

template<class T1 = int, class T2 = ts_ms_t>
constexpr T1	time_shield::ms_to_hour (T2 ts) noexcept
	Converts a timestamp from milliseconds to hours.

template<class T>
constexpr ts_t	time_shield::hour_to_sec_impl (T t, std::true_type tag) noexcept
	Helper function for converting hours to seconds (floating-point version).

template<class T>
constexpr ts_t	time_shield::hour_to_sec_impl (T t, std::false_type tag) noexcept
	Helper function for converting hours to seconds (integral version).

template<class T1 = ts_t, class T2>
constexpr T1	time_shield::hour_to_sec (T2 ts) noexcept
	Converts a timestamp from hours to seconds.

template<class T1 = int, class T2 = ts_t>
constexpr T1	time_shield::sec_to_hour (T2 ts) noexcept
	Converts a timestamp from seconds to hours.

template<class T = int>
constexpr fts_t	time_shield::hour_to_fsec (T hr) noexcept
	Converts a timestamp from hours to floating-point seconds.

template<class T = ts_t>
constexpr double	time_shield::sec_to_fhour (T ts) noexcept
	Converts a timestamp from seconds to floating-point hours.

template<class T = year_t>
constexpr T	time_shield::get_unix_year (ts_t ts) noexcept
	Converts a UNIX timestamp to a year.

template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::hour24_to_12 (T hour) noexcept
	Converts a 24-hour format hour to a 12-hour format.

template<class T1 = DateTimeStruct, class T2 = ts_t>
T1	time_shield::to_date_time (T2 ts)
	Converts a timestamp to a date-time structure.

template<class T>
T	time_shield::to_date_time_ms (ts_ms_t ts)
	Converts a timestamp in milliseconds to a date-time structure with milliseconds.

template<class T1 = year_t, class T2 = int>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_timestamp (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0)
	Converts a date and time to a timestamp.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::dt_to_timestamp (const T &date_time)
	Converts a date-time structure to a timestamp.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::tm_to_timestamp (const std::tm *timeinfo)
	Converts a std::tm structure to a timestamp.

template<class T1 = year_t, class T2 = int>
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::to_timestamp_ms (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T2 ms=0)
	Converts a date and time to a timestamp in milliseconds.

template<class T>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::dt_to_timestamp_ms (const T &date_time)
	Converts a date-time structure to a timestamp in milliseconds.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::tm_to_timestamp_ms (const std::tm *timeinfo)
	Converts a std::tm structure to a timestamp in milliseconds.

template<class T1 = year_t, class T2 = int, class T3 = int>
TIME_SHIELD_CONSTEXPR fts_t	time_shield::to_ftimestamp (T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0)
	Converts a date and time to a floating-point timestamp.

template<class T>
TIME_SHIELD_CONSTEXPR fts_t	time_shield::dt_to_ftimestamp (const T &date_time)
	Converts a date-time structure to a floating-point timestamp.

TIME_SHIELD_CONSTEXPR fts_t	time_shield::tm_to_ftimestamp (const std::tm *timeinfo)
	Converts a std::tm structure to a floating-point timestamp.

template<class T = uday_t>
constexpr T	time_shield::get_unix_day (ts_t ts=time_shield::ts()) noexcept
	Get UNIX day.

template<class T = int>
constexpr T	time_shield::get_days_difference (ts_t start, ts_t stop) noexcept
	Get the number of days between two timestamps.

template<class T = uday_t>
constexpr T	time_shield::get_unix_day_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Get UNIX day from milliseconds timestamp.

template<class T = ts_t>
constexpr T	time_shield::unix_day_to_timestamp (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp in seconds.

template<class T = ts_t>
constexpr T	time_shield::unix_day_to_timestamp_ms (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp in milliseconds.

template<class T = ts_t>
constexpr T	time_shield::end_of_day_from_unix_day (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp representing the end of the day in seconds.

template<class T = ts_ms_t>
constexpr T	time_shield::end_of_day_from_unix_day_ms (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp representing the end of the day in milliseconds.

template<class T = ts_ms_t>
constexpr T	time_shield::start_of_next_day_from_unix_day (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp representing the start of the next day in seconds.

template<class T = ts_ms_t>
constexpr T	time_shield::start_of_next_day_from_unix_day_ms (uday_t unix_day) noexcept
	Converts a UNIX day to a timestamp representing the start of the next day in milliseconds.

template<class T = int64_t>
constexpr T	time_shield::get_unix_min (ts_t ts=time_shield::ts())
	Get UNIX minute.

template<class T = int>
constexpr T	time_shield::sec_of_day (ts_t ts=time_shield::ts()) noexcept
	Get the second of the day.

template<class T = int>
constexpr T	time_shield::sec_of_day_ms (ts_ms_t ts_ms) noexcept
	Get the second of the day from milliseconds timestamp.

template<class T1 = int, class T2 = int>
constexpr T1	time_shield::sec_of_day (T2 hour, T2 min, T2 sec) noexcept
	Get the second of the day.

template<class T = int>
constexpr T	time_shield::sec_of_min (ts_t ts=time_shield::ts())
	Get the second of the minute.

template<class T = int>
constexpr T	time_shield::sec_of_hour (ts_t ts=time_shield::ts())
	Get the second of the hour.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_year (ts_t ts=time_shield::ts())
	Get the year from the timestamp.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_year_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Get the year from the timestamp in milliseconds.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_year (ts_t ts) noexcept
	Get the start of the year timestamp.

TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_year_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the start of the year timestamp in milliseconds.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_year_date (T year)
	Get the timestamp of the start of the year.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_year_date_ms (T year)
	Get the timestamp in milliseconds of the start of the year.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_year (ts_t ts=time_shield::ts())
	Get the end-of-year timestamp.

template<class T = year_t>
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::end_of_year_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Get the timestamp in milliseconds of the end of the year.

template<class T = int>
T	time_shield::day_of_year (ts_t ts=time_shield::ts())
	Get the day of the year.

template<class T = Month>
TIME_SHIELD_CONSTEXPR T	time_shield::month_of_year (ts_t ts) noexcept
	Get the month of the year.

template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::day_of_month (ts_t ts=time_shield::ts())
	Get the day of the month.

template<class T1 = int, class T2 = year_t, class T3 = int>
constexpr T1	time_shield::num_days_in_month (T2 year, T3 month) noexcept
	Get the number of days in a month.

template<class T1 = int>
TIME_SHIELD_CONSTEXPR T1	time_shield::num_days_in_month_ts (ts_t ts=time_shield::ts()) noexcept
	Get the number of days in the month of the given timestamp.

template<class T1 = int, class T2 = year_t>
constexpr T1	time_shield::num_days_in_year (T2 year) noexcept
	Get the number of days in a given year.

template<class T = int>
constexpr T	time_shield::num_days_in_year_ts (ts_t ts=time_shield::ts())
	Get the number of days in the current year.

constexpr ts_t	time_shield::start_of_day (ts_t ts=time_shield::ts()) noexcept
	Get the start of the day timestamp.

template<class T = int>
constexpr ts_t	time_shield::start_of_prev_day (ts_t ts=time_shield::ts(), T days=1) noexcept
	Get timestamp of the start of the previous day.

constexpr ts_t	time_shield::start_of_day_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the start of the day timestamp in seconds.

constexpr ts_ms_t	time_shield::start_of_day_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the start of the day timestamp in milliseconds.

template<class T = int>
constexpr ts_t	time_shield::start_of_next_day (ts_t ts, T days=1) noexcept
	Get the timestamp of the start of the day after a specified number of days.

template<class T = int>
constexpr ts_ms_t	time_shield::start_of_next_day_ms (ts_ms_t ts_ms, T days=1) noexcept
	Get the timestamp of the start of the day after a specified number of days.

template<class T = int>
constexpr ts_t	time_shield::next_day (ts_t ts, T days=1) noexcept
	Calculate the timestamp for a specified number of days in the future.

template<class T = int>
constexpr ts_ms_t	time_shield::next_day_ms (ts_ms_t ts_ms, T days=1) noexcept
	Calculate the timestamp for a specified number of days in the future (milliseconds).

constexpr ts_t	time_shield::end_of_day (ts_t ts=time_shield::ts()) noexcept
	Get the timestamp at the end of the day.

constexpr ts_t	time_shield::end_of_day_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the end of the day in seconds.

constexpr ts_ms_t	time_shield::end_of_day_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the end of the day in milliseconds.

template<class T1 = Weekday, class T2 = year_t, class T3 = int, class T4 = int>
constexpr T1	time_shield::day_of_week_date (T2 year, T3 month, T4 day)
	Get the day of the week.

template<class T1 = Weekday, class T2>
constexpr T1	time_shield::get_weekday_from_date (const T2 &date)
	Get the day of the week from a date structure.

template<class T = Weekday>
constexpr T	time_shield::get_weekday_from_ts (ts_t ts) noexcept
	Get the weekday from a timestamp.

template<class T = Weekday>
constexpr T	time_shield::get_weekday_from_ts_ms (ts_ms_t ts_ms)
	Get the weekday from a timestamp in milliseconds.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_month (ts_t ts=time_shield::ts())
	Get the timestamp at the start of the current month.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_month (ts_t ts=time_shield::ts())
	Get the last timestamp of the current month.

TIME_SHIELD_CONSTEXPR ts_t	time_shield::last_sunday_of_month (ts_t ts=time_shield::ts())
	Get the timestamp of the last Sunday of the current month.

template<class T1 = int, class T2 = year_t, class T3 = int>
TIME_SHIELD_CONSTEXPR T1	time_shield::last_sunday_month_day (T2 year, T3 month)
	Get the day of the last Sunday of the given month and year.

constexpr ts_t	time_shield::start_of_hour (ts_t ts=time_shield::ts()) noexcept
	Get the timestamp at the start of the hour.

constexpr ts_t	time_shield::start_of_hour_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the start of the hour.

constexpr ts_ms_t	time_shield::start_of_hour_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the start of the hour. This function sets the minute and second to zero.

constexpr ts_t	time_shield::end_of_hour (ts_t ts=time_shield::ts()) noexcept
	Get the timestamp at the end of the hour. This function sets the minute and second to 59.

constexpr ts_t	time_shield::end_of_hour_sec (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the end of the hour.

constexpr ts_ms_t	time_shield::end_of_hour_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Get the timestamp at the end of the hour.

template<class T = int>
constexpr T	time_shield::hour_of_day (ts_t ts=time_shield::ts()) noexcept
	Get the hour of the day.

constexpr ts_t	time_shield::start_of_week (ts_t ts=time_shield::ts())
	Get the timestamp of the beginning of the week.

constexpr ts_t	time_shield::end_of_week (ts_t ts=time_shield::ts())
	Get the timestamp of the end of the week.

constexpr ts_t	time_shield::start_of_saturday (ts_t ts=time_shield::ts())
	Get the timestamp of the start of Saturday.

constexpr ts_t	time_shield::start_of_min (ts_t ts=time_shield::ts()) noexcept
	Get the timestamp of the beginning of the minute.

constexpr ts_t	time_shield::end_of_min (ts_t ts=time_shield::ts()) noexcept
	Get the timestamp of the end of the minute.

template<class T = int>
constexpr T	time_shield::min_of_day (ts_t ts=time_shield::ts()) noexcept
	Get minute of day. This function returns a value between 0 to 1439 (minute of day).

template<class T = int>
constexpr T	time_shield::min_of_hour (ts_t ts=time_shield::ts()) noexcept
	Get minute of hour. This function returns a value between 0 to 59.

template<class T = int>
constexpr ts_t	time_shield::start_of_period (T p, ts_t ts=time_shield::ts())
	Get the timestamp of the start of the period.

template<class T = int>
constexpr ts_t	time_shield::end_of_period (T p, ts_t ts=time_shield::ts())
	Get the timestamp of the end of the period.

template<class T = TimeZoneStruct>
T	time_shield::to_time_zone (tz_t offset)
	Converts an integer to a time zone structure.

Detailed Description

Utility functions for converting between time units.

A comprehensive set of functions and utilities for working with timestamps and time-related data.

This module provides functionalities to convert, manipulate, and analyze timestamps in seconds, milliseconds, and floating-point formats. It also includes utilities for working with date-time structures, UNIX days, and various time units (hours, minutes, seconds, etc.).

Key Features:

Convert timestamps between seconds, milliseconds, and floating-point seconds.
Extract components such as nanoseconds, microseconds, and milliseconds from timestamps.
Convert timestamps to and from date-time structures.
Calculate the start and end of various time intervals (e.g., days, hours, months, years).
Analyze time data (e.g., day of the week, day of the year, days in a month or year).

Usage Examples:

Obtain the millisecond component of a timestamp:
auto ms = time_shield::ms_of_sec(123.456);

time_shield::ms_of_sec
T ms_of_sec() noexcept
Get the millisecond part of the current second.
Definition time_utils.hpp:121
Convert a date-time structure to a timestamp:
auto ts = time_shield::to_timestamp(2024, 11, 25, 14, 30, 0);

time_shield::to_timestamp
TIME_SHIELD_CONSTEXPR ts_t to_timestamp(const T &date_time)
Alias for dt_to_timestamp function.
Definition time_conversion_aliases.hpp:692

time_shield::ts
ts_t ts() noexcept
Get the current UTC timestamp in seconds.
Definition time_utils.hpp:128
Determine the start of the current year:
auto year_start = time_shield::start_of_year(current_timestamp());

time_shield::start_of_year
TIME_SHIELD_CONSTEXPR ts_t start_of_year(ts_t ts) noexcept
Get the start of the year timestamp.
Definition time_conversions.hpp:1085

time_shield::year_start
TIME_SHIELD_CONSTEXPR ts_t year_start(ts_t ts=time_shield::ts())
Alias for start_of_year function.
Definition time_conversion_aliases.hpp:1503

Function Documentation

◆ cet_to_gmt()

datetime time_shield::cet_to_gmt ( const datetime cet )

Convert Central European Time to Greenwich Mean Time.

Parameters

cet	Timestamp in seconds in CET.

Returns: Timestamp in seconds in GMT.

Definition at line 27 of file time_zone_conversions.mqh.

◆ day_end() [1/2]

long time_shield::day_end ( long ts )

Alias for end_of_day.

Get the timestamp at the end of the day.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts	Timestamp.

Returns: Timestamp at the end of the day.

Definition at line 539 of file time_conversions.mqh.

◆ day_end() [2/2]

ts_t time_shield::day_end ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for end_of_day function.

Get the timestamp at the end of the day.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts	Timestamp.

Returns: Timestamp at the end of the day.

Definition at line 1681 of file time_conversion_aliases.hpp.

◆ day_end_ms() [1/2]

long time_shield::day_end_ms ( long ts_ms )

Alias for end_of_day_ms.

Get the timestamp at the end of the day in milliseconds.

This function sets the hour to 23, minute to 59, second to 59, and millisecond to 999.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in milliseconds.

Definition at line 561 of file time_conversions.mqh.

◆ day_end_ms() [2/2]

ts_ms_t time_shield::day_end_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for end_of_day_ms function.

Get the timestamp at the end of the day in milliseconds.

This function sets the hour to 23, minute to 59, second to 59, and millisecond to 999.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in milliseconds.

Definition at line 1697 of file time_conversion_aliases.hpp.

◆ day_end_sec() [1/2]

long time_shield::day_end_sec ( long ts_ms )

Alias for end_of_day_sec.

Get the timestamp at the end of the day in seconds.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in seconds.

Definition at line 550 of file time_conversions.mqh.

◆ day_end_sec() [2/2]

ts_t time_shield::day_end_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for end_of_day_sec function.

Get the timestamp at the end of the day in seconds.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in seconds.

Definition at line 1689 of file time_conversion_aliases.hpp.

◆ day_of_month() [1/2]

int time_shield::day_of_month ( long ts )

Get the day of the month.

Parameters

ts	Timestamp in seconds.

Returns: Day of the month.

Definition at line 768 of file time_conversions.mqh.

◆ day_of_month() [2/2]

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::day_of_month ( ts_t ts = time_shield::ts() )

inline

Get the day of the month.

This function returns the day of the month for the specified timestamp.

Parameters

ts	Timestamp.

Returns: Day of the month.

Definition at line 1326 of file time_conversions.hpp.

◆ day_of_week() [1/8]

Weekday time_shield::day_of_week ( const DateTimeStruct & dt )

Alias for get_weekday_from_date with DateTimeStruct.

Get weekday from a DateTimeStruct.

Parameters

dt	Date structure with fields year, mon, day.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 604 of file time_conversions.mqh.

◆ day_of_week() [2/8]

Weekday time_shield::day_of_week ( const MqlDateTime & dt )

Alias for get_weekday_from_date with MqlDateTime.

Get weekday from a MqlDateTime structure.

Parameters

dt	Standard MqlDateTime structure.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 612 of file time_conversions.mqh.

◆ day_of_week() [3/8]

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::day_of_week ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1797 of file time_conversion_aliases.hpp.

◆ day_of_week() [4/8]

Weekday time_shield::day_of_week ( long ts )

Alias for get_weekday_from_ts.

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 623 of file time_conversions.mqh.

◆ day_of_week() [5/8]

Weekday time_shield::day_of_week	(	long	year,
		int	month,
		int	day )

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 582 of file time_conversions.mqh.

◆ day_of_week() [6/8]

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>

T time_shield::day_of_week ( U ts )

constexprnoexcept

Alias for get_weekday_from_ts.

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1815 of file time_conversion_aliases.hpp.

◆ day_of_week() [7/8]

template<class T1 = Weekday>

T1 time_shield::day_of_week	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1706 of file time_conversion_aliases.hpp.

◆ day_of_week() [8/8]

template<class T1 = Weekday>

T1 time_shield::day_of_week	(	year_t	year,
		Month	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1713 of file time_conversion_aliases.hpp.

◆ day_of_week_date() [1/2]

Weekday time_shield::day_of_week_date	(	long	year,
		int	month,
		int	day )

Get the day of the week for a date.

Parameters

year	Year value.
month	Month value.
day	Day of the month.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 568 of file time_conversions.mqh.

◆ day_of_week_date() [2/2]

template<class T1 = Weekday, class T2 = year_t, class T3 = int, class T4 = int>

T1 time_shield::day_of_week_date	(	T2	year,
		T3	month,
		T4	day )

constexpr

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1575 of file time_conversions.hpp.

◆ day_of_week_dt() [1/3]

Weekday time_shield::day_of_week_dt ( const DateTimeStruct & dt )

Alias for get_weekday_from_date with DateTimeStruct.

Get weekday from a DateTimeStruct.

Parameters

dt	Date structure with fields year, mon, day.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 600 of file time_conversions.mqh.

◆ day_of_week_dt() [2/3]

Weekday time_shield::day_of_week_dt ( const MqlDateTime & dt )

Alias for get_weekday_from_date with MqlDateTime.

Get weekday from a MqlDateTime structure.

Parameters

dt	Standard MqlDateTime structure.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 608 of file time_conversions.mqh.

◆ day_of_week_dt() [3/3]

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::day_of_week_dt ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1789 of file time_conversion_aliases.hpp.

◆ day_of_week_ms() [1/2]

Weekday time_shield::day_of_week_ms ( long ts_ms )

Alias for get_weekday_from_ts_ms.

Get the weekday from a timestamp in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 634 of file time_conversions.mqh.

◆ day_of_week_ms() [2/2]

template<class T = Weekday>

T time_shield::day_of_week_ms ( ts_ms_t ts_ms )

constexpr

Alias for get_weekday_from_ts_ms function.

Get the weekday from a timestamp in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1845 of file time_conversion_aliases.hpp.

◆ day_of_year() [1/2]

int time_shield::day_of_year ( long ts )

Get the day of the year.

Parameters

ts	Timestamp in seconds.

Returns: Day of the year (1-366).

Definition at line 735 of file time_conversions.mqh.

◆ day_of_year() [2/2]

template<class T = int>

T time_shield::day_of_year ( ts_t ts = time_shield::ts() )

inline

Get the day of the year.

This function returns the day of the year for the specified timestamp.

Parameters

ts	Timestamp.

Returns: Day of the year.

Definition at line 1283 of file time_conversions.hpp.

◆ day_start() [1/2]

long time_shield::day_start ( long ts )

Alias for start_of_day.

Get the start of the day timestamp.

This function returns the timestamp at the start of the day. The function sets the hours, minutes, and seconds to zero.

Parameters

ts	Timestamp.

Returns: Start of the day timestamp.

Definition at line 454 of file time_conversions.mqh.

◆ day_start() [2/2]

ts_t time_shield::day_start ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for start_of_day function.

Get the start of the day timestamp.

This function returns the timestamp at the start of the day. The function sets the hours, minutes, and seconds to zero.

Parameters

ts	Timestamp.

Returns: Start of the day timestamp.

Definition at line 1624 of file time_conversion_aliases.hpp.

◆ day_start_ms() [1/2]

long time_shield::day_start_ms ( long ts_ms )

Alias for start_of_day_ms.

Get the start of the day timestamp in milliseconds.

This function returns the timestamp at the start of the day in milliseconds. The function sets the hours, minutes, seconds, and milliseconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in milliseconds.

Definition at line 488 of file time_conversions.mqh.

◆ day_start_ms() [2/2]

ts_ms_t time_shield::day_start_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for start_of_day_ms function.

Get the start of the day timestamp in milliseconds.

This function returns the timestamp at the start of the day in milliseconds. The function sets the hours, minutes, seconds, and milliseconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in milliseconds.

Definition at line 1655 of file time_conversion_aliases.hpp.

◆ day_start_sec() [1/2]

long time_shield::day_start_sec ( long ts_ms )

Alias for start_of_day_sec.

Get the start of the day timestamp in seconds.

This function returns the timestamp at the start of the day in seconds. The function sets the hours, minutes, and seconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in seconds.

Definition at line 477 of file time_conversions.mqh.

◆ day_start_sec() [2/2]

ts_t time_shield::day_start_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for start_of_day_sec function.

Get the start of the day timestamp in seconds.

This function returns the timestamp at the start of the day in seconds. The function sets the hours, minutes, and seconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in seconds.

Definition at line 1641 of file time_conversion_aliases.hpp.

◆ days() [1/2]

int time_shield::days	(	long	start,
		long	stop )

Alias for get_days_difference.

Get the number of days between two timestamps.

This function calculates the number of days between two timestamps.

Template Parameters

T	The type of the return value, defaults to int.

Parameters

start	The timestamp of the start of the period.
stop	The timestamp of the end of the period.

Returns: The number of days between start and stop.

Definition at line 1106 of file time_conversions.mqh.

◆ days() [2/2]

template<class T = int>

T time_shield::days	(	ts_t	start,
		ts_t	stop )

constexprnoexcept

Alias for get_days_difference function.

Get the number of days between two timestamps.

This function calculates the number of days between two timestamps.

Template Parameters

T	The type of the return value, defaults to int.

Parameters

start	The timestamp of the start of the period.
stop	The timestamp of the end of the period.

Returns: The number of days between start and stop.

Definition at line 1463 of file time_conversion_aliases.hpp.

◆ days_in_month() [1/4]

int time_shield::days_in_month ( long ts )

Alias for num_days_in_month_ts.

Get the number of days in the month of the given timestamp.

This function calculates and returns the number of days in the month of the specified timestamp.

Parameters

ts	The timestamp to extract month and year from.

Returns: The number of days in the month of the given timestamp.

Definition at line 827 of file time_conversions.mqh.

◆ days_in_month() [2/4]

int time_shield::days_in_month	(	long	year,
		int	month )

Alias for num_days_in_month.

Get the number of days in a month.

Parameters

year	Year value.
month	Month value.

Returns: Number of days in the month.

Definition at line 807 of file time_conversions.mqh.

◆ days_in_month() [3/4]

template<class T1 = int, class T2 = year_t, class T3 = int>

T1 time_shield::days_in_month	(	T2	year,
		T3	month )

constexprnoexcept

Alias for num_days_in_month function.

Parameters

year	Year as an integer.
month	Month as an integer.

Returns: The number of days in the given month and year.

Definition at line 1582 of file time_conversion_aliases.hpp.

◆ days_in_month() [4/4]

template<class T1 = int>

T1 time_shield::days_in_month ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for num_days_in_month_ts function.

Get the number of days in the month of the given timestamp.

This function calculates and returns the number of days in the month of the specified timestamp.

Parameters

ts	The timestamp to extract month and year from.

Returns: The number of days in the month of the given timestamp.

Definition at line 1598 of file time_conversion_aliases.hpp.

◆ days_in_year() [1/2]

int time_shield::days_in_year ( long year )

Alias for num_days_in_year.

Get the number of days in a given year.

This function calculates and returns the number of days in the specified year.

Parameters

year Year.

Returns: Number of days in the given year.

Definition at line 839 of file time_conversions.mqh.

◆ days_in_year() [2/2]

template<class T1 = int, class T2 = year_t>

T1 time_shield::days_in_year ( T2 year )

constexprnoexcept

Alias for num_days_in_year function.

Get the number of days in a given year.

This function calculates and returns the number of days in the specified year.

Parameters

year Year.

Returns: Number of days in the given year.

Definition at line 1607 of file time_conversion_aliases.hpp.

◆ days_in_year_ts() [1/2]

int time_shield::days_in_year_ts ( long ts )

Alias for num_days_in_year_ts.

Get the number of days in the current year.

This function calculates and returns the number of days in the current year based on the provided timestamp.

Parameters

ts	Timestamp.

Returns: Number of days in the current year.

Definition at line 851 of file time_conversions.mqh.

◆ days_in_year_ts() [2/2]

template<class T = int>

T time_shield::days_in_year_ts ( ts_t ts = time_shield::ts() )

constexpr

Alias for num_days_in_year_ts function.

Get the number of days in the current year.

This function calculates and returns the number of days in the current year based on the provided timestamp.

Parameters

ts	Timestamp.

Returns: Number of days in the current year.

Definition at line 1616 of file time_conversion_aliases.hpp.

◆ dow() [1/3]

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::dow ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1805 of file time_conversion_aliases.hpp.

◆ dow() [2/3]

template<class T1 = Weekday>

T1 time_shield::dow	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1748 of file time_conversion_aliases.hpp.

◆ dow() [3/3]

template<class T1 = Weekday>

T1 time_shield::dow	(	year_t	year,
		Month	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1755 of file time_conversion_aliases.hpp.

◆ dow_from_date()

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::dow_from_date ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1773 of file time_conversion_aliases.hpp.

◆ dow_ts()

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>

T time_shield::dow_ts ( U ts )

constexprnoexcept

Alias for get_weekday_from_ts.

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1822 of file time_conversion_aliases.hpp.

◆ dt_to_ftimestamp() [1/3]

double time_shield::dt_to_ftimestamp ( const DateTimeStruct & dt )

Convert a DateTimeStruct to floating-point timestamp.

Parameters

dt	Structure with date and time fields.

Returns: Floating-point timestamp.

Definition at line 422 of file time_conversions.mqh.

◆ dt_to_ftimestamp() [2/3]

double time_shield::dt_to_ftimestamp ( const MqlDateTime & dt )

Convert an MqlDateTime structure to floating-point timestamp.

Parameters

dt	Standard MqlDateTime structure.

Returns: Floating-point timestamp.

Definition at line 429 of file time_conversions.mqh.

◆ dt_to_ftimestamp() [3/3]

template<class T>

TIME_SHIELD_CONSTEXPR fts_t time_shield::dt_to_ftimestamp ( const T & date_time )

inline

Converts a date-time structure to a floating-point timestamp.

This function converts a given date and time structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure containing year, month, day, hour, minute, second, and millisecond fields.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 817 of file time_conversions.hpp.

◆ dt_to_timestamp() [1/3]

long time_shield::dt_to_timestamp ( const DateTimeStruct & dt )

Convert a DateTimeStruct to timestamp.

Parameters

dt	Structure with date and time fields.

Returns: Timestamp in seconds.

Definition at line 321 of file time_conversions.mqh.

◆ dt_to_timestamp() [2/3]

long time_shield::dt_to_timestamp ( const MqlDateTime & dt )

Convert an MqlDateTime structure to timestamp.

Parameters

dt	Standard MqlDateTime structure.

Returns: Timestamp in seconds.

Definition at line 335 of file time_conversions.mqh.

◆ dt_to_timestamp() [3/3]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::dt_to_timestamp ( const T & date_time )

inline

Converts a date-time structure to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 675 of file time_conversions.hpp.

◆ dt_to_timestamp_ms() [1/3]

long time_shield::dt_to_timestamp_ms ( const DateTimeStruct & dt )

Convert a DateTimeStruct to a timestamp in milliseconds.

Parameters

dt	Structure with date and time fields.

Returns: Timestamp in milliseconds.

Definition at line 400 of file time_conversions.mqh.

◆ dt_to_timestamp_ms() [2/3]

long time_shield::dt_to_timestamp_ms ( const MqlDateTime & dt )

Convert an MqlDateTime structure to a timestamp in milliseconds.

Parameters

dt	Standard MqlDateTime structure.

Returns: Timestamp in milliseconds.

Definition at line 407 of file time_conversions.mqh.

◆ dt_to_timestamp_ms() [3/3]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::dt_to_timestamp_ms ( const T & date_time )

inline

Converts a date-time structure to a timestamp in milliseconds.

This function converts a given date-time structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 750 of file time_conversions.hpp.

◆ eet_to_gmt()

datetime time_shield::eet_to_gmt ( const datetime eet )

Convert Eastern European Time to Greenwich Mean Time.

Parameters

eet	Timestamp in seconds in EET.

Returns: Timestamp in seconds in GMT.

Definition at line 104 of file time_zone_conversions.mqh.

◆ end_of_day() [1/2]

long time_shield::end_of_day ( long ts )

Get the end of the day for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 23:59:59 of the same day.

Definition at line 533 of file time_conversions.mqh.

◆ end_of_day() [2/2]

ts_t time_shield::end_of_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the timestamp at the end of the day.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts	Timestamp.

Returns: Timestamp at the end of the day.

Definition at line 1535 of file time_conversions.hpp.

◆ end_of_day_from_unix_day() [1/2]

long time_shield::end_of_day_from_unix_day ( long uday )

Get end of day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at 23:59:59 of the specified day.

Definition at line 1180 of file time_conversions.mqh.

◆ end_of_day_from_unix_day() [2/2]

template<class T = ts_t>

T time_shield::end_of_day_from_unix_day ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp representing the end of the day in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the end of the specified day (23:59:59).

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the end of the specified UNIX day.

Definition at line 923 of file time_conversions.hpp.

◆ end_of_day_from_unix_day_ms() [1/2]

long time_shield::end_of_day_from_unix_day_ms ( long uday )

Get end of day timestamp in ms from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at 23:59:59.999 of the specified day.

Definition at line 1187 of file time_conversions.mqh.

◆ end_of_day_from_unix_day_ms() [2/2]

template<class T = ts_ms_t>

T time_shield::end_of_day_from_unix_day_ms ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp representing the end of the day in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the end of the specified day (23:59:59.999).

Template Parameters

T	The return type of the function (default is ts_ms_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the end of the specified UNIX day.

Definition at line 936 of file time_conversions.hpp.

◆ end_of_day_ms() [1/2]

long time_shield::end_of_day_ms ( long ts_ms )

Get the end of the day for a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at 23:59:59.999 of the same day.

Definition at line 555 of file time_conversions.mqh.

◆ end_of_day_ms() [2/2]

ts_ms_t time_shield::end_of_day_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the end of the day in milliseconds.

This function sets the hour to 23, minute to 59, second to 59, and millisecond to 999.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in milliseconds.

Definition at line 1559 of file time_conversions.hpp.

◆ end_of_day_sec() [1/2]

long time_shield::end_of_day_sec ( long ts_ms )

Get the end of the day in seconds from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at 23:59:59 of the same day in seconds.

Definition at line 544 of file time_conversions.mqh.

◆ end_of_day_sec() [2/2]

ts_t time_shield::end_of_day_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the end of the day in seconds.

This function sets the hour to 23, minute to 59, and second to 59.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at the end of the day in seconds.

Definition at line 1547 of file time_conversions.hpp.

◆ end_of_hour() [1/2]

long time_shield::end_of_hour ( long ts )

Get the end of the hour for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at HH:59:59 of the same hour.

Definition at line 935 of file time_conversions.mqh.

◆ end_of_hour() [2/2]

ts_t time_shield::end_of_hour ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the timestamp at the end of the hour. This function sets the minute and second to 59.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the end of the hour.

Definition at line 1713 of file time_conversions.hpp.

◆ end_of_hour_ms() [1/2]

long time_shield::end_of_hour_ms ( long ts_ms )

Get the end of the hour for a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at HH:59:59.999 of the hour.

Definition at line 957 of file time_conversions.mqh.

◆ end_of_hour_ms() [2/2]

ts_ms_t time_shield::end_of_hour_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in milliseconds.

Definition at line 1737 of file time_conversions.hpp.

◆ end_of_hour_sec() [1/2]

long time_shield::end_of_hour_sec ( long ts_ms )

Get the end of the hour in seconds from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at HH:59:59 of the hour in seconds.

Definition at line 946 of file time_conversions.mqh.

◆ end_of_hour_sec() [2/2]

ts_t time_shield::end_of_hour_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in seconds.

Definition at line 1725 of file time_conversions.hpp.

◆ end_of_min() [1/2]

long time_shield::end_of_min ( long ts )

Get the end of the minute for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at mm:59 of the same minute.

Definition at line 1023 of file time_conversions.mqh.

◆ end_of_min() [2/2]

ts_t time_shield::end_of_min ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the timestamp of the end of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the minute.

Definition at line 1807 of file time_conversions.hpp.

◆ end_of_month() [1/2]

long time_shield::end_of_month ( long ts )

Get the timestamp at the end of the month.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 23:59:59 on the last day of the month.

Definition at line 867 of file time_conversions.mqh.

◆ end_of_month() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::end_of_month ( ts_t ts = time_shield::ts() )

inline

Get the last timestamp of the current month.

This function returns the last timestamp of the current month, setting the day to the last day of the month and the time to 23:59:59.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Last timestamp of the current month

Definition at line 1641 of file time_conversions.hpp.

◆ end_of_period() [1/2]

long time_shield::end_of_period	(	int	p,
		long	ts )

Get the end of a period.

Parameters

p	Period length in seconds.
ts	Timestamp (default current).

Returns: Timestamp of the end of the period.

Definition at line 1061 of file time_conversions.mqh.

◆ end_of_period() [2/2]

template<class T = int>

ts_t time_shield::end_of_period	(	T	p,
		ts_t	ts = time_shield::ts() )

constexpr

Get the timestamp of the end of the period.

Parameters

p	Period duration in seconds.
ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the period.

Definition at line 1851 of file time_conversions.hpp.

◆ end_of_week() [1/2]

long time_shield::end_of_week ( long ts )

Get the end of the week (Saturday end).

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 23:59:59 on Saturday of the current week.

Definition at line 990 of file time_conversions.mqh.

◆ end_of_week() [2/2]

ts_t time_shield::end_of_week ( ts_t ts = time_shield::ts() )

constexpr

Get the timestamp of the end of the week.

This function finds the timestamp of the end of the week, which corresponds to the end of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the week.

Definition at line 1776 of file time_conversions.hpp.

◆ end_of_year() [1/2]

long time_shield::end_of_year ( long ts )

Get the end of the year for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp of 23:59:59 on December 31st of the year.

Definition at line 648 of file time_conversions.mqh.

◆ end_of_year() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::end_of_year ( ts_t ts = time_shield::ts() )

inline

Get the end-of-year timestamp.

This function finds the last timestamp of the current year.

Parameters

ts	Timestamp.

Returns: End-of-year timestamp.

Definition at line 1202 of file time_conversions.hpp.

◆ end_of_year_ms() [1/2]

long time_shield::end_of_year_ms ( long ts_ms )

Get the end of the year in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp of 23:59:59.999 on December 31st of the year.

Definition at line 724 of file time_conversions.mqh.

◆ end_of_year_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::end_of_year_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Get the timestamp in milliseconds of the end of the year.

This function finds the last timestamp of the current year in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: End-of-year timestamp in milliseconds.

Definition at line 1270 of file time_conversions.hpp.

◆ eod_from_unix_day()

long time_shield::eod_from_unix_day ( long uday )

Alias for end_of_day_from_unix_day.

Get end of day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at 23:59:59 of the specified day.

Definition at line 1193 of file time_conversions.mqh.

◆ eod_from_unix_day_ms()

long time_shield::eod_from_unix_day_ms ( long uday )

Alias for end_of_day_from_unix_day_ms.

Get end of day timestamp in ms from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at 23:59:59.999 of the specified day.

Definition at line 1197 of file time_conversions.mqh.

◆ final_sunday_month_day() [1/2]

int time_shield::final_sunday_month_day	(	long	year,
		int	month )

Alias for last_sunday_month_day.

Get the day of the last Sunday of the given month and year.

This function returns the day of the last Sunday of the specified month and year.

Parameters

year	Year
month	Month (1 = January, 12 = December)

Returns: Day of the last Sunday of the given month and year

Definition at line 897 of file time_conversions.mqh.

◆ final_sunday_month_day() [2/2]

template<class T1 = int, class T2 = year_t, class T3 = int>

TIME_SHIELD_CONSTEXPR T1 time_shield::final_sunday_month_day	(	T2	year,
		T3	month )

inline

Alias for last_sunday_month_day function.

Get the day of the last Sunday of the given month and year.

This function returns the day of the last Sunday of the specified month and year.

Parameters

year	Year
month	Month (1 = January, 12 = December)

Returns: Day of the last Sunday of the given month and year

Definition at line 1878 of file time_conversion_aliases.hpp.

◆ final_sunday_of_month() [1/2]

long time_shield::final_sunday_of_month ( long ts )

Alias for last_sunday_of_month.

Get the timestamp of the last Sunday of the current month.

This function returns the timestamp of the last Sunday of the current month, setting the day to the last Sunday and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp of the last Sunday of the current month

Definition at line 884 of file time_conversions.mqh.

◆ final_sunday_of_month() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::final_sunday_of_month ( ts_t ts = time_shield::ts() )

inline

Alias for last_sunday_of_month function.

Get the timestamp of the last Sunday of the current month.

This function returns the timestamp of the last Sunday of the current month, setting the day to the last Sunday and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp of the last Sunday of the current month

Definition at line 1869 of file time_conversion_aliases.hpp.

◆ finish_of_hour() [1/2]

long time_shield::finish_of_hour ( long ts )

Alias for end_of_hour.

Get the timestamp at the end of the hour. This function sets the minute and second to 59.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the end of the hour.

Definition at line 941 of file time_conversions.mqh.

◆ finish_of_hour() [2/2]

ts_t time_shield::finish_of_hour ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for end_of_hour function.

Get the timestamp at the end of the hour. This function sets the minute and second to 59.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the end of the hour.

Definition at line 1910 of file time_conversion_aliases.hpp.

◆ finish_of_hour_ms() [1/2]

long time_shield::finish_of_hour_ms ( long ts_ms )

Alias for end_of_hour_ms.

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in milliseconds.

Definition at line 963 of file time_conversions.mqh.

◆ finish_of_hour_ms() [2/2]

ts_ms_t time_shield::finish_of_hour_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for end_of_hour_ms function.

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in milliseconds.

Definition at line 1926 of file time_conversion_aliases.hpp.

◆ finish_of_hour_sec() [1/2]

long time_shield::finish_of_hour_sec ( long ts_ms )

Alias for end_of_hour_sec.

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in seconds.

Definition at line 952 of file time_conversions.mqh.

◆ finish_of_hour_sec() [2/2]

ts_t time_shield::finish_of_hour_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for end_of_hour_sec function.

Get the timestamp at the end of the hour.

This function sets the minute and second to 59.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the end of the hour in seconds.

Definition at line 1918 of file time_conversion_aliases.hpp.

◆ finish_of_min() [1/2]

long time_shield::finish_of_min ( long ts )

Alias for end_of_min.

Get the timestamp of the end of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the minute.

Definition at line 1029 of file time_conversions.mqh.

◆ finish_of_min() [2/2]

ts_t time_shield::finish_of_min ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for end_of_min function.

Get the timestamp of the end of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the minute.

Definition at line 1975 of file time_conversion_aliases.hpp.

◆ finish_of_week() [1/2]

long time_shield::finish_of_week ( long ts )

Alias for end_of_week.

Get the timestamp of the end of the week.

This function finds the timestamp of the end of the week, which corresponds to the end of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the week.

Definition at line 996 of file time_conversions.mqh.

◆ finish_of_week() [2/2]

ts_t time_shield::finish_of_week ( ts_t ts = time_shield::ts() )

constexpr

Alias for end_of_week function.

Get the timestamp of the end of the week.

This function finds the timestamp of the end of the week, which corresponds to the end of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the end of the week.

Definition at line 1951 of file time_conversion_aliases.hpp.

◆ fsec_to_ms()

ts_ms_t time_shield::fsec_to_ms ( fts_t ts )

inlinenoexcept

Converts a floating-point timestamp from seconds to milliseconds.

Parameters

ts	Timestamp in floating-point seconds.

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 112 of file time_conversions.hpp.

◆ ftimestamp() [1/3]

fts_t time_shield::ftimestamp ( const std::tm * timeinfo )

constexpr

Alias for tm_to_ftimestamp.

Converts a std::tm structure to a floating-point timestamp.

This function converts a given std::tm structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to the std::tm structure containing the date and time.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1447 of file time_conversion_aliases.hpp.

◆ ftimestamp() [2/3]

template<class T>

fts_t time_shield::ftimestamp ( const T & date_time )

constexpr

Alias for dt_to_ftimestamp.

Converts a date-time structure to a floating-point timestamp.

This function converts a given date and time structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure containing year, month, day, hour, minute, second, and millisecond fields.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1417 of file time_conversion_aliases.hpp.

◆ ftimestamp() [3/3]

template<class T1 = year_t, class T2 = int, class T3 = int>

fts_t time_shield::ftimestamp	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0,
		T3	ms = 0 )

constexpr

Alias for to_ftimestamp.

This function converts a given date and time to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is year_t).
T2	The type of the month, day, hour, minute, and second parameters (default is int).
T3	The type of the millisecond parameter (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).
ms	The millisecond value (default is 0).

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_ftimestamp

Definition at line 1383 of file time_conversion_aliases.hpp.

◆ fts() [1/3]

fts_t time_shield::fts ( const std::tm * timeinfo )

constexpr

Alias for tm_to_ftimestamp.

Converts a std::tm structure to a floating-point timestamp.

This function converts a given std::tm structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to the std::tm structure containing the date and time.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1440 of file time_conversion_aliases.hpp.

◆ fts() [2/3]

template<class T>

fts_t time_shield::fts ( const T & date_time )

constexpr

Alias for dt_to_ftimestamp.

Converts a date-time structure to a floating-point timestamp.

This function converts a given date and time structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure containing year, month, day, hour, minute, second, and millisecond fields.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1409 of file time_conversion_aliases.hpp.

◆ fts() [3/3]

template<class T1 = year_t, class T2 = int, class T3 = int>

fts_t time_shield::fts	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0,
		T3	ms = 0 )

constexpr

Alias for to_ftimestamp.

This function converts a given date and time to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is year_t).
T2	The type of the month, day, hour, minute, and second parameters (default is int).
T3	The type of the millisecond parameter (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).
ms	The millisecond value (default is 0).

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_ftimestamp

Definition at line 1359 of file time_conversion_aliases.hpp.

◆ get_days() [1/2]

int time_shield::get_days	(	long	start,
		long	stop )

Alias for get_days_difference.

Get the number of days between two timestamps.

This function calculates the number of days between two timestamps.

Template Parameters

T	The type of the return value, defaults to int.

Parameters

start	The timestamp of the start of the period.
stop	The timestamp of the end of the period.

Returns: The number of days between start and stop.

Definition at line 1102 of file time_conversions.mqh.

◆ get_days() [2/2]

template<class T = int>

T time_shield::get_days	(	ts_t	start,
		ts_t	stop )

constexprnoexcept

Alias for get_days_difference function.

Get the number of days between two timestamps.

This function calculates the number of days between two timestamps.

Template Parameters

T	The type of the return value, defaults to int.

Parameters

start	The timestamp of the start of the period.
stop	The timestamp of the end of the period.

Returns: The number of days between start and stop.

Definition at line 1456 of file time_conversion_aliases.hpp.

◆ get_days_difference() [1/2]

int time_shield::get_days_difference	(	long	start,
		long	stop )

Get number of days between two timestamps.

Parameters

start	Start timestamp in seconds.
stop	End timestamp in seconds.

Returns: Difference in days.

Definition at line 1096 of file time_conversions.mqh.

◆ get_days_difference() [2/2]

template<class T = int>

T time_shield::get_days_difference	(	ts_t	start,
		ts_t	stop )

constexprnoexcept

Get the number of days between two timestamps.

This function calculates the number of days between two timestamps.

Template Parameters

T	The type of the return value, defaults to int.

Parameters

start	The timestamp of the start of the period.
stop	The timestamp of the end of the period.

Returns: The number of days between start and stop.

Definition at line 864 of file time_conversions.hpp.

◆ get_dow()

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::get_dow ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1765 of file time_conversion_aliases.hpp.

◆ get_dow_from_ts()

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>

T time_shield::get_dow_from_ts ( U ts )

constexprnoexcept

Alias for get_weekday_from_ts.

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1829 of file time_conversion_aliases.hpp.

◆ get_timestamp() [1/5]

ts_t time_shield::get_timestamp ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 746 of file time_conversion_aliases.hpp.

◆ get_timestamp() [2/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_timestamp	(	year_t	year,
		int	month,
		int	day )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 455 of file time_conversion_aliases.hpp.

◆ get_timestamp() [3/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 475 of file time_conversion_aliases.hpp.

◆ get_timestamp() [4/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 496 of file time_conversion_aliases.hpp.

◆ get_timestamp() [5/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 518 of file time_conversion_aliases.hpp.

◆ get_timestamp_ms() [1/5]

ts_ms_t time_shield::get_timestamp_ms	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 973 of file time_conversion_aliases.hpp.

◆ get_timestamp_ms() [2/5]

ts_ms_t time_shield::get_timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 991 of file time_conversion_aliases.hpp.

◆ get_timestamp_ms() [3/5]

ts_ms_t time_shield::get_timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1010 of file time_conversion_aliases.hpp.

◆ get_timestamp_ms() [4/5]

ts_ms_t time_shield::get_timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1030 of file time_conversion_aliases.hpp.

◆ get_timestamp_ms() [5/5]

ts_ms_t time_shield::get_timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec,
		int	ms )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.
ms	The millisecond value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1051 of file time_conversion_aliases.hpp.

◆ get_ts() [1/5]

ts_t time_shield::get_ts ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 734 of file time_conversion_aliases.hpp.

◆ get_ts() [2/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_ts	(	year_t	year,
		int	month,
		int	day )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 373 of file time_conversion_aliases.hpp.

◆ get_ts() [3/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 393 of file time_conversion_aliases.hpp.

◆ get_ts() [4/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 414 of file time_conversion_aliases.hpp.

◆ get_ts() [5/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 436 of file time_conversion_aliases.hpp.

◆ get_ts_ms() [1/5]

ts_ms_t time_shield::get_ts_ms	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 878 of file time_conversion_aliases.hpp.

◆ get_ts_ms() [2/5]

ts_ms_t time_shield::get_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 896 of file time_conversion_aliases.hpp.

◆ get_ts_ms() [3/5]

ts_ms_t time_shield::get_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 915 of file time_conversion_aliases.hpp.

◆ get_ts_ms() [4/5]

ts_ms_t time_shield::get_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 935 of file time_conversion_aliases.hpp.

◆ get_ts_ms() [5/5]

ts_ms_t time_shield::get_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec,
		int	ms )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.
ms	The millisecond value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 956 of file time_conversion_aliases.hpp.

◆ get_unix_day() [1/2]

long time_shield::get_unix_day ( long ts )

Get UNIX day from timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Number of days since UNIX epoch.

Definition at line 1072 of file time_conversions.mqh.

◆ get_unix_day() [2/2]

template<class T = uday_t>

T time_shield::get_unix_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 849 of file time_conversions.hpp.

◆ get_unix_day_ms() [1/2]

long time_shield::get_unix_day_ms ( long ts_ms )

Get UNIX day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Number of days since UNIX epoch.

Definition at line 1111 of file time_conversions.mqh.

◆ get_unix_day_ms() [2/2]

template<class T = uday_t>

T time_shield::get_unix_day_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

constexprnoexcept

Get UNIX day from milliseconds timestamp.

This function returns the number of days elapsed since the UNIX epoch, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

t_ms	Timestamp in milliseconds (default is current timestamp in milliseconds).

Returns: Number of days since the UNIX epoch.

Definition at line 878 of file time_conversions.hpp.

◆ get_unix_min() [1/2]

long time_shield::get_unix_min ( long ts )

Get UNIX minute from timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Minutes since UNIX epoch.

Definition at line 1236 of file time_conversions.mqh.

◆ get_unix_min() [2/2]

template<class T = int64_t>

T time_shield::get_unix_min ( ts_t ts = time_shield::ts() )

constexpr

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 976 of file time_conversions.hpp.

◆ get_unix_year() [1/2]

long time_shield::get_unix_year ( long ts )

Convert a UNIX timestamp to a year.

Parameters

ts	UNIX timestamp in seconds.

Returns: Year corresponding to the given timestamp.

Definition at line 202 of file time_conversions.mqh.

◆ get_unix_year() [2/2]

template<class T = year_t>

T time_shield::get_unix_year ( ts_t ts )

constexprnoexcept

Converts a UNIX timestamp to a year.

Template Parameters

T	The type of the year (default is year_t).

Parameters

ts	UNIX timestamp.

Returns: T Year corresponding to the given timestamp.

Definition at line 408 of file time_conversions.hpp.

◆ get_unixday() [1/2]

long time_shield::get_unixday ( long ts )

Alias for get_unix_day.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 1082 of file time_conversions.mqh.

◆ get_unixday() [2/2]

template<class T = uday_t>

T time_shield::get_unixday ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for get_unix_day function.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 38 of file time_conversion_aliases.hpp.

◆ get_unixday_ms() [1/2]

long time_shield::get_unixday_ms ( long ts_ms )

Alias for get_unix_day_ms.

Get UNIX day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Number of days since UNIX epoch.

Definition at line 1121 of file time_conversions.mqh.

◆ get_unixday_ms() [2/2]

template<class T = uday_t>

T time_shield::get_unixday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for get_unix_day_ms function.

Get UNIX day from milliseconds timestamp.

This function returns the number of days elapsed since the UNIX epoch, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

t_ms	Timestamp in milliseconds (default is current timestamp in milliseconds).

Returns: Number of days since the UNIX epoch.

Definition at line 72 of file time_conversion_aliases.hpp.

◆ get_weekday() [1/3]

Weekday time_shield::get_weekday	(	long	year,
		int	month,
		int	day )

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 578 of file time_conversions.mqh.

◆ get_weekday() [2/3]

template<class T1 = Weekday>

T1 time_shield::get_weekday	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1720 of file time_conversion_aliases.hpp.

◆ get_weekday() [3/3]

template<class T1 = Weekday>

T1 time_shield::get_weekday	(	year_t	year,
		Month	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1727 of file time_conversion_aliases.hpp.

◆ get_weekday_from_date() [1/3]

Weekday time_shield::get_weekday_from_date ( const DateTimeStruct & dt )

Get weekday from a DateTimeStruct.

Parameters

dt	Date structure with fields year, mon, day.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 587 of file time_conversions.mqh.

◆ get_weekday_from_date() [2/3]

Weekday time_shield::get_weekday_from_date ( const MqlDateTime & dt )

Get weekday from a MqlDateTime structure.

Parameters

dt	Standard MqlDateTime structure.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 594 of file time_conversions.mqh.

◆ get_weekday_from_date() [3/3]

template<class T1 = Weekday, class T2>

T1 time_shield::get_weekday_from_date ( const T2 & date )

constexpr

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1595 of file time_conversions.hpp.

◆ get_weekday_from_ts() [1/2]

Weekday time_shield::get_weekday_from_ts ( long ts )

Get weekday from timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 617 of file time_conversions.mqh.

◆ get_weekday_from_ts() [2/2]

template<class T = Weekday>

T time_shield::get_weekday_from_ts ( ts_t ts )

constexprnoexcept

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1605 of file time_conversions.hpp.

◆ get_weekday_from_ts_ms() [1/2]

Weekday time_shield::get_weekday_from_ts_ms ( long ts_ms )

Get weekday from millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Weekday (SUN=0, MON=1, ... SAT=6).

Definition at line 628 of file time_conversions.mqh.

◆ get_weekday_from_ts_ms() [2/2]

template<class T = Weekday>

T time_shield::get_weekday_from_ts_ms ( ts_ms_t ts_ms )

constexpr

Get the weekday from a timestamp in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1615 of file time_conversions.hpp.

◆ get_year() [1/2]

long time_shield::get_year ( long ts )

Get the year from a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Year of the given timestamp.

Definition at line 240 of file time_conversions.mqh.

◆ get_year() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::get_year ( ts_t ts = time_shield::ts() )

inline

Get the year from the timestamp.

This function returns the year of the specified timestamp in seconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1058 of file time_conversions.hpp.

◆ get_year_ms() [1/2]

long time_shield::get_year_ms ( long ts_ms )

Get the year from a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Year of the given timestamp.

Definition at line 255 of file time_conversions.mqh.

◆ get_year_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::get_year_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Get the year from the timestamp in milliseconds.

This function returns the year of the specified timestamp in milliseconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts_ms Timestamp in milliseconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1072 of file time_conversions.hpp.

◆ h24_to_h12() [1/2]

int time_shield::h24_to_h12 ( int hour )

Alias for hour24_to_12.

Converts a 24-hour format hour to a 12-hour format.

Template Parameters

T	Numeric type of the hour (default is int).

Parameters

hour	The hour in 24-hour format to convert.

Returns: The hour in 12-hour format.

Definition at line 193 of file time_conversions.mqh.

◆ h24_to_h12() [2/2]

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::h24_to_h12 ( T hour )

inlinenoexcept

Alias for hour24_to_12 function.

Converts a 24-hour format hour to a 12-hour format.

Template Parameters

T	Numeric type of the hour (default is int).

Parameters

hour	The hour in 24-hour format to convert.

Returns: The hour in 12-hour format.

Definition at line 234 of file time_conversion_aliases.hpp.

◆ hour24_to_12() [1/2]

int time_shield::hour24_to_12 ( int hour )

Convert a 24-hour format hour to a 12-hour format.

Parameters

hour	Hour value in 24-hour format.

Returns: Hour value in 12-hour format.

Definition at line 186 of file time_conversions.mqh.

◆ hour24_to_12() [2/2]

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::hour24_to_12 ( T hour )

inlinenoexcept

Converts a 24-hour format hour to a 12-hour format.

Template Parameters

T	Numeric type of the hour (default is int).

Parameters

hour	The hour in 24-hour format to convert.

Returns: The hour in 12-hour format.

Definition at line 445 of file time_conversions.hpp.

◆ hour_begin() [1/2]

long time_shield::hour_begin ( long ts )

Alias for start_of_hour.

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the start of the hour.

Definition at line 908 of file time_conversions.mqh.

◆ hour_begin() [2/2]

ts_t time_shield::hour_begin ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for start_of_hour function.

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the start of the hour.

Definition at line 1886 of file time_conversion_aliases.hpp.

◆ hour_begin_ms() [1/2]

long time_shield::hour_begin_ms ( long ts_ms )

Alias for start_of_hour_ms.

Get the timestamp at the start of the hour. This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in milliseconds.

Definition at line 930 of file time_conversions.mqh.

◆ hour_begin_ms() [2/2]

ts_ms_t time_shield::hour_begin_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for start_of_hour_ms function.

Get the timestamp at the start of the hour. This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in milliseconds.

Definition at line 1902 of file time_conversion_aliases.hpp.

◆ hour_begin_sec() [1/2]

long time_shield::hour_begin_sec ( long ts_ms )

Alias for start_of_hour_sec.

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in seconds.

Definition at line 919 of file time_conversions.mqh.

◆ hour_begin_sec() [2/2]

ts_t time_shield::hour_begin_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for start_of_hour_sec function.

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in seconds.

Definition at line 1894 of file time_conversion_aliases.hpp.

◆ hour_in_day() [1/2]

int time_shield::hour_in_day ( long ts )

Alias for hour_of_day.

Get the hour of the day.

This function returns a value between 0 to 23 representing the hour of the day.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Hour of the day.

Definition at line 974 of file time_conversions.mqh.

◆ hour_in_day() [2/2]

template<class T = int>

T time_shield::hour_in_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for hour_of_day function.

Get the hour of the day.

This function returns a value between 0 to 23 representing the hour of the day.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Hour of the day.

Definition at line 1935 of file time_conversion_aliases.hpp.

◆ hour_of_day() [1/2]

int time_shield::hour_of_day ( long ts )

Get the hour of the day.

Parameters

ts	Timestamp in seconds.

Returns: Hour value 0-23.

Definition at line 968 of file time_conversions.mqh.

◆ hour_of_day() [2/2]

template<class T = int>

T time_shield::hour_of_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the hour of the day.

This function returns a value between 0 to 23 representing the hour of the day.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Hour of the day.

Definition at line 1750 of file time_conversions.hpp.

◆ hour_to_fsec() [1/2]

double time_shield::hour_to_fsec ( double hr )

Convert hours to floating-point seconds.

Parameters

hr	Hours value.

Returns: Seconds as double.

Definition at line 172 of file time_conversions.mqh.

◆ hour_to_fsec() [2/2]

template<class T = int>

fts_t time_shield::hour_to_fsec ( T hr )

constexprnoexcept

Converts a timestamp from hours to floating-point seconds.

Template Parameters

T	The type of the input timestamp (default is int).

Parameters

hr	Timestamp in hours.

Returns: fts_t Timestamp in floating-point seconds.

Definition at line 388 of file time_conversions.hpp.

◆ hour_to_ms() [1/2]

long time_shield::hour_to_ms ( double hr )

Convert hours to milliseconds.

Parameters

hr	Hours value.

Returns: Milliseconds value.

Definition at line 144 of file time_conversions.mqh.

◆ hour_to_ms() [2/2]

template<class T1 = ts_ms_t, class T2>

T1 time_shield::hour_to_ms ( T2 ts )

constexprnoexcept

Converts a timestamp from hours to milliseconds.

Template Parameters

T1	The type of the output timestamp (default is ts_ms_t).
T2	The type of the input timestamp.

Parameters

ts	Timestamp in hours.

Returns: T1 Timestamp in milliseconds.

Definition at line 299 of file time_conversions.hpp.

◆ hour_to_ms_impl() [1/2]

template<class T>

ts_ms_t time_shield::hour_to_ms_impl	(	T	t,
		std::false_type	tag )

constexprnoexcept

Helper function for converting hours to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.
tag	Type tag used to select the integral overload (must be std::false_type).

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 288 of file time_conversions.hpp.

◆ hour_to_ms_impl() [2/2]

template<class T>

ts_ms_t time_shield::hour_to_ms_impl	(	T	t,
		std::true_type	tag )

constexprnoexcept

Helper function for converting hours to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.
tag	std::true_type indicates a floating-point type (double or float).

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 278 of file time_conversions.hpp.

◆ hour_to_sec() [1/2]

long time_shield::hour_to_sec ( double hr )

Convert hours to seconds.

Parameters

hr	Hours value.

Returns: Seconds value.

Definition at line 158 of file time_conversions.mqh.

◆ hour_to_sec() [2/2]

template<class T1 = ts_t, class T2>

T1 time_shield::hour_to_sec ( T2 ts )

constexprnoexcept

Converts a timestamp from hours to seconds.

Template Parameters

T1	The type of the output timestamp (default is ts_t).
T2	The type of the input timestamp.

Parameters

ts	Timestamp in hours.

Returns: T1 Timestamp in seconds.

Definition at line 357 of file time_conversions.hpp.

◆ hour_to_sec_impl() [1/2]

template<class T>

ts_t time_shield::hour_to_sec_impl	(	T	t,
		std::false_type	tag )

constexprnoexcept

Helper function for converting hours to seconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.
tag	std::false_type indicates a non-floating-point type.

Returns: ts_t Timestamp in seconds.

Definition at line 346 of file time_conversions.hpp.

◆ hour_to_sec_impl() [2/2]

template<class T>

ts_t time_shield::hour_to_sec_impl	(	T	t,
		std::true_type	tag )

constexprnoexcept

Helper function for converting hours to seconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.
tag	std::true_type indicates a floating-point type (double or float).

Returns: ts_t Timestamp in seconds.

Definition at line 336 of file time_conversions.hpp.

◆ last_day_of_month() [1/2]

long time_shield::last_day_of_month ( long ts )

Alias for end_of_month.

Get the last timestamp of the current month.

This function returns the last timestamp of the current month, setting the day to the last day of the month and the time to 23:59:59.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Last timestamp of the current month

Definition at line 873 of file time_conversions.mqh.

◆ last_day_of_month() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::last_day_of_month ( ts_t ts = time_shield::ts() )

inline

Alias for end_of_month function.

Get the last timestamp of the current month.

This function returns the last timestamp of the current month, setting the day to the last day of the month and the time to 23:59:59.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Last timestamp of the current month

Definition at line 1861 of file time_conversion_aliases.hpp.

◆ last_sunday_month_day() [1/2]

int time_shield::last_sunday_month_day	(	long	year,
		int	month )

Get the day of the last Sunday for the given month and year.

Parameters

year	Year value.
month	Month value.

Returns: Day of the last Sunday of that month.

Definition at line 890 of file time_conversions.mqh.

◆ last_sunday_month_day() [2/2]

template<class T1 = int, class T2 = year_t, class T3 = int>

TIME_SHIELD_CONSTEXPR T1 time_shield::last_sunday_month_day	(	T2	year,
		T3	month )

inline

Get the day of the last Sunday of the given month and year.

This function returns the day of the last Sunday of the specified month and year.

Parameters

year	Year
month	Month (1 = January, 12 = December)

Returns: Day of the last Sunday of the given month and year

Definition at line 1668 of file time_conversions.hpp.

◆ last_sunday_of_month() [1/2]

long time_shield::last_sunday_of_month ( long ts )

Get the timestamp of the last Sunday of the month.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 of the last Sunday of the month.

Definition at line 878 of file time_conversions.mqh.

◆ last_sunday_of_month() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::last_sunday_of_month ( ts_t ts = time_shield::ts() )

inline

Get the timestamp of the last Sunday of the current month.

This function returns the timestamp of the last Sunday of the current month, setting the day to the last Sunday and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp of the last Sunday of the current month

Definition at line 1654 of file time_conversions.hpp.

◆ min_begin() [1/2]

long time_shield::min_begin ( long ts )

Alias for start_of_min.

Get the timestamp of the beginning of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the minute.

Definition at line 1018 of file time_conversions.mqh.

◆ min_begin() [2/2]

ts_t time_shield::min_begin ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for start_of_min function.

Get the timestamp of the beginning of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the minute.

Definition at line 1967 of file time_conversion_aliases.hpp.

◆ min_in_hour()

int time_shield::min_in_hour ( long ts )

Alias for min_of_hour.

Get minute of hour. This function returns a value between 0 to 59.

Parameters

ts	Timestamp in seconds (default: current timestamp).

Returns: Minute of hour.

Definition at line 1047 of file time_conversions.mqh.

◆ min_of_day() [1/2]

int time_shield::min_of_day ( long ts )

Get the minute of the day.

Parameters

ts	Timestamp in seconds.

Returns: Minute of the day (0-1439).

Definition at line 1034 of file time_conversions.mqh.

◆ min_of_day() [2/2]

template<class T = int>

T time_shield::min_of_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get minute of day. This function returns a value between 0 to 1439 (minute of day).

Parameters

ts	Timestamp in seconds (default: current timestamp).

Returns: Minute of day.

Definition at line 1818 of file time_conversions.hpp.

◆ min_of_hour() [1/2]

int time_shield::min_of_hour ( long ts )

Get the minute of the hour.

Parameters

ts	Timestamp in seconds.

Returns: Minute of the hour (0-59).

Definition at line 1041 of file time_conversions.mqh.

◆ min_of_hour() [2/2]

template<class T = int>

T time_shield::min_of_hour ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get minute of hour. This function returns a value between 0 to 59.

Parameters

ts	Timestamp in seconds (default: current timestamp).

Returns: Minute of hour.

Definition at line 1829 of file time_conversions.hpp.

◆ min_to_fsec() [1/2]

double time_shield::min_to_fsec ( double min )

Convert minutes to floating-point seconds.

Parameters

min	Minutes value.

Returns: Seconds as double.

Definition at line 126 of file time_conversions.mqh.

◆ min_to_fsec() [2/2]

template<class T = int>

fts_t time_shield::min_to_fsec ( T min )

constexprnoexcept

Converts a timestamp from minutes to floating-point seconds.

Template Parameters

T	The type of the input timestamp (default is int).

Parameters

min	Timestamp in minutes.

Returns: fts_t Timestamp in floating-point seconds.

Definition at line 254 of file time_conversions.hpp.

◆ min_to_ms() [1/2]

long time_shield::min_to_ms ( double min )

Convert minutes to milliseconds.

Parameters

min	Minutes value.

Returns: Milliseconds value.

Definition at line 98 of file time_conversions.mqh.

◆ min_to_ms() [2/2]

template<class T1 = ts_ms_t, class T2>

T1 time_shield::min_to_ms ( T2 ts )

constexprnoexcept

Converts a timestamp from minutes to milliseconds.

Template Parameters

T1	The type of the output timestamp (default is ts_ms_t).
T2	The type of the input timestamp.

Parameters

ts	Timestamp in minutes.

Returns: T1 Timestamp in milliseconds.

Definition at line 166 of file time_conversions.hpp.

◆ min_to_ms_impl() [1/2]

template<class T>

ts_ms_t time_shield::min_to_ms_impl	(	T	t,
		std::false_type	tag )

constexprnoexcept

Helper function for converting minutes to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.
tag	std::false_type indicates a non-floating-point type.

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 155 of file time_conversions.hpp.

◆ min_to_ms_impl() [2/2]

template<class T>

ts_ms_t time_shield::min_to_ms_impl	(	T	t,
		std::true_type	tag )

constexprnoexcept

Helper function for converting minutes to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.
tag	std::true_type indicates a floating-point type (double or float).

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 145 of file time_conversions.hpp.

◆ min_to_sec() [1/2]

long time_shield::min_to_sec ( double min )

Convert minutes to seconds.

Parameters

min	Minutes value.

Returns: Seconds value.

Definition at line 112 of file time_conversions.mqh.

◆ min_to_sec() [2/2]

template<class T1 = ts_t, class T2>

T1 time_shield::min_to_sec ( T2 ts )

constexprnoexcept

Converts a timestamp from minutes to seconds.

Template Parameters

T1	The type of the output timestamp (default is ts_t).
T2	The type of the input timestamp.

Parameters

ts	Timestamp in minutes.

Returns: T1 Timestamp in seconds.

Definition at line 223 of file time_conversions.hpp.

◆ min_to_sec_impl() [1/2]

template<class T>

ts_t time_shield::min_to_sec_impl	(	T	t,
		std::false_type	tag )

constexprnoexcept

Helper function for converting minutes to seconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.
tag	std::false_type indicates a non-floating-point type.

Returns: ts_t Timestamp in seconds.

Definition at line 212 of file time_conversions.hpp.

◆ min_to_sec_impl() [2/2]

template<class T>

ts_t time_shield::min_to_sec_impl	(	T	t,
		std::true_type	tag )

constexprnoexcept

Helper function for converting minutes to seconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.
tag	std::true_type indicates a floating-point type (double or float).

Returns: ts_t Timestamp in seconds.

Definition at line 202 of file time_conversions.hpp.

◆ month_begin() [1/2]

long time_shield::month_begin ( long ts )

Alias for start_of_month.

Get the timestamp at the start of the current month.

This function returns the timestamp at the start of the current month, setting the day to the first day of the month and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp at the start of the current month

Definition at line 862 of file time_conversions.mqh.

◆ month_begin() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::month_begin ( ts_t ts = time_shield::ts() )

inline

Alias for start_of_month function.

Get the timestamp at the start of the current month.

This function returns the timestamp at the start of the current month, setting the day to the first day of the month and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp at the start of the current month

Definition at line 1853 of file time_conversion_aliases.hpp.

◆ month_of_year() [1/2]

Month time_shield::month_of_year ( long ts )

Get the month of the year.

Parameters

ts	Timestamp in seconds.

Returns: Month of the year.

Definition at line 742 of file time_conversions.mqh.

◆ month_of_year() [2/2]

template<class T = Month>

TIME_SHIELD_CONSTEXPR T time_shield::month_of_year ( ts_t ts )

inlinenoexcept

Get the month of the year.

This function returns the month of the year for the specified timestamp.

Parameters

ts	Timestamp.

Returns: Month of the year.

Definition at line 1296 of file time_conversions.hpp.

◆ ms_of_sec() [1/2]

int time_shield::ms_of_sec ( double ts )

Get the millisecond part of a floating-point timestamp.

Parameters

ts	Timestamp in seconds with fractional part.

Returns: Milliseconds of the second.

Definition at line 54 of file time_conversions.mqh.

◆ ms_of_sec() [2/2]

template<class T = int>

T time_shield::ms_of_sec ( fts_t ts )

constexprnoexcept

Get the millisecond part of the second from a floating-point timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in floating-point seconds.

Returns: T Millisecond part of the second.

Definition at line 51 of file time_conversions.hpp.

◆ ms_of_ts() [1/2]

int time_shield::ms_of_ts ( long ts_ms )

Get the millisecond part of a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Milliseconds component.

Definition at line 62 of file time_conversions.mqh.

◆ ms_of_ts() [2/2]

template<class T = int>

T time_shield::ms_of_ts ( ts_ms_t ts )

constexprnoexcept

Get the millisecond part of the timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in milliseconds.

Returns: T Millisecond part of the timestamp.

Definition at line 61 of file time_conversions.hpp.

◆ ms_to_fsec() [1/2]

double time_shield::ms_to_fsec ( long ms )

Convert milliseconds to floating-point seconds.

Parameters

ms	Timestamp in milliseconds.

Returns: Seconds as double.

Definition at line 87 of file time_conversions.mqh.

◆ ms_to_fsec() [2/2]

template<class T = ts_ms_t>

fts_t time_shield::ms_to_fsec ( T ts_ms )

constexprnoexcept

Converts a timestamp from milliseconds to floating-point seconds.

Template Parameters

T	The type of the input timestamp (default is ts_ms_t).

Parameters

ts_ms Timestamp in milliseconds.

Returns: fts_t Timestamp in floating-point seconds.

Definition at line 131 of file time_conversions.hpp.

◆ ms_to_hour() [1/2]

int time_shield::ms_to_hour ( long ms )

Convert milliseconds to hours (integer part).

Parameters

ms	Milliseconds value.

Returns: Hours value.

Definition at line 151 of file time_conversions.mqh.

◆ ms_to_hour() [2/2]

template<class T1 = int, class T2 = ts_ms_t>

T1 time_shield::ms_to_hour ( T2 ts )

constexprnoexcept

Converts a timestamp from milliseconds to hours.

Template Parameters

T1	The type of the output timestamp (default is int).
T2	The type of the input timestamp (default is ts_ms_t).

Parameters

ts	Timestamp in milliseconds.

Returns: T1 Timestamp in hours.

Definition at line 321 of file time_conversions.hpp.

◆ ms_to_min() [1/2]

int time_shield::ms_to_min ( long ms )

Convert milliseconds to minutes (integer part).

Parameters

ms	Milliseconds value.

Returns: Minutes value.

Definition at line 105 of file time_conversions.mqh.

◆ ms_to_min() [2/2]

template<class T1 = int, class T2 = ts_ms_t>

T1 time_shield::ms_to_min ( T2 ts )

constexprnoexcept

Converts a timestamp from milliseconds to minutes.

Template Parameters

T1	The type of the output timestamp (default is int).
T2	The type of the input timestamp (default is ts_ms_t).

Parameters

ts	Timestamp in milliseconds.

Returns: T1 Timestamp in minutes.

Definition at line 188 of file time_conversions.hpp.

◆ ms_to_sec() [1/2]

long time_shield::ms_to_sec ( long ms )

Convert milliseconds to seconds (integer part).

Parameters

ms	Timestamp in milliseconds.

Returns: Seconds value.

Definition at line 80 of file time_conversions.mqh.

◆ ms_to_sec() [2/2]

template<class T1 = ts_t, class T2 = ts_ms_t>

T1 time_shield::ms_to_sec ( T2 ts_ms )

constexprnoexcept

Converts a timestamp from milliseconds to seconds.

Template Parameters

T1	The type of the output timestamp (default is ts_t).
T2	The type of the input timestamp (default is ts_ms_t).

Parameters

ts_ms Timestamp in milliseconds.

Returns: T1 Timestamp in seconds.

Definition at line 122 of file time_conversions.hpp.

◆ next_day() [1/2]

long time_shield::next_day	(	long	ts,
		int	days = 1 )

Add days to a timestamp without adjusting to start of day.

Parameters

ts	Timestamp in seconds.
days	Number of days to add (default 1).

Returns: Timestamp shifted forward by the given days.

Definition at line 518 of file time_conversions.mqh.

◆ next_day() [2/2]

template<class T = int>

ts_t time_shield::next_day	(	ts_t	ts,
		T	days = 1 )

constexprnoexcept

Calculate the timestamp for a specified number of days in the future.

Adds the given number of days to the provided timestamp, without adjusting to the start of the day.

Parameters

ts	The current timestamp in seconds.
days	The number of days to add to the current timestamp (default is 1).

Returns: The timestamp in seconds after adding the specified number of days.

Definition at line 1511 of file time_conversions.hpp.

◆ next_day_from_unix_day() [1/2]

long time_shield::next_day_from_unix_day ( long uday )

Alias for start_of_next_day_from_unix_day.

Get start of next day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in seconds.

Definition at line 1231 of file time_conversions.mqh.

◆ next_day_from_unix_day() [2/2]

template<class T = ts_t>

T time_shield::next_day_from_unix_day ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day function.

Converts a UNIX day to a timestamp representing the start of the next day in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the next day (00:00:00).

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the next UNIX day.

Definition at line 165 of file time_conversion_aliases.hpp.

◆ next_day_from_unix_day_ms()

template<class T = ts_ms_t>

T time_shield::next_day_from_unix_day_ms ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day_ms function.

Converts a UNIX day to a timestamp representing the start of the next day in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the next day (00:00:00.000).

Template Parameters

T	The return type of the function (default is ts_ms_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the next UNIX day.

Definition at line 188 of file time_conversion_aliases.hpp.

◆ next_day_ms() [1/2]

long time_shield::next_day_ms	(	long	ts_ms,
		int	days = 1 )

Add days to a millisecond timestamp without adjusting to start of day.

Parameters

ts_ms	Timestamp in milliseconds.
days	Number of days to add (default 1).

Returns: Timestamp shifted forward by the given days in milliseconds.

Definition at line 526 of file time_conversions.mqh.

◆ next_day_ms() [2/2]

template<class T = int>

ts_ms_t time_shield::next_day_ms	(	ts_ms_t	ts_ms,
		T	days = 1 )

constexprnoexcept

Calculate the timestamp for a specified number of days in the future (milliseconds).

Adds the given number of days to the provided timestamp, without adjusting to the start of the day.

Parameters

ts_ms	The current timestamp in milliseconds.
days	The number of days to add to the current timestamp (default is 1).

Returns: The timestamp in milliseconds after adding the specified number of days.

Definition at line 1523 of file time_conversions.hpp.

◆ next_day_start() [1/2]

long time_shield::next_day_start	(	long	ts,
		int	days = 1 )

Alias for start_of_next_day.

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp.

Parameters

ts	The current timestamp in seconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in seconds representing the beginning of the specified future day.

Definition at line 500 of file time_conversions.mqh.

◆ next_day_start() [2/2]

template<class T = int>

ts_t time_shield::next_day_start	(	ts_t	ts,
		T	days = 1 )

constexprnoexcept

Alias for start_of_next_day function.

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp.

Parameters

ts	The current timestamp in seconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in seconds representing the beginning of the specified future day.

Definition at line 1664 of file time_conversion_aliases.hpp.

◆ next_day_start_ms() [1/2]

long time_shield::next_day_start_ms	(	long	ts_ms,
		int	days = 1 )

Alias for start_of_next_day_ms.

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp in milliseconds.

Parameters

ts_ms	The current timestamp in milliseconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in milliseconds representing the beginning of the specified future day.

Definition at line 512 of file time_conversions.mqh.

◆ next_day_start_ms() [2/2]

template<class T = int>

ts_ms_t time_shield::next_day_start_ms	(	ts_ms_t	ts_ms,
		T	days = 1 )

constexprnoexcept

Alias for start_of_next_day_ms function.

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp in milliseconds.

Parameters

ts_ms	The current timestamp in milliseconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in milliseconds representing the beginning of the specified future day.

Definition at line 1673 of file time_conversion_aliases.hpp.

◆ next_day_unix_day() [1/2]

long time_shield::next_day_unix_day ( long uday )

Alias for start_of_next_day_from_unix_day.

Get start of next day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in seconds.

Definition at line 1215 of file time_conversions.mqh.

◆ next_day_unix_day() [2/2]

template<class T = ts_t>

T time_shield::next_day_unix_day ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day function.

Converts a UNIX day to a timestamp representing the start of the next day in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the next day (00:00:00).

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the next UNIX day.

Definition at line 172 of file time_conversion_aliases.hpp.

◆ next_day_unix_day_ms() [1/2]

long time_shield::next_day_unix_day_ms ( long uday )

Alias for start_of_next_day_from_unix_day_ms.

Get start of next day timestamp in ms from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in milliseconds.

Definition at line 1223 of file time_conversions.mqh.

◆ next_day_unix_day_ms() [2/2]

template<class T = ts_ms_t>

T time_shield::next_day_unix_day_ms ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day_ms function.

Converts a UNIX day to a timestamp representing the start of the next day in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the next day (00:00:00.000).

Template Parameters

T	The return type of the function (default is ts_ms_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the next UNIX day.

Definition at line 195 of file time_conversion_aliases.hpp.

◆ next_day_unixday() [1/2]

long time_shield::next_day_unixday ( long uday )

Alias for start_of_next_day_from_unix_day.

Get start of next day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in seconds.

Definition at line 1219 of file time_conversions.mqh.

◆ next_day_unixday() [2/2]

template<class T = ts_t>

T time_shield::next_day_unixday ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day function.

Converts a UNIX day to a timestamp representing the start of the next day in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the next day (00:00:00).

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the next UNIX day.

Definition at line 179 of file time_conversion_aliases.hpp.

◆ next_day_unixday_ms() [1/2]

long time_shield::next_day_unixday_ms ( long uday )

Alias for start_of_next_day_from_unix_day_ms.

Get start of next day timestamp in ms from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in milliseconds.

Definition at line 1227 of file time_conversions.mqh.

◆ next_day_unixday_ms() [2/2]

template<class T = ts_ms_t>

T time_shield::next_day_unixday_ms ( uday_t unix_day )

constexprnoexcept

Alias for start_of_next_day_from_unix_day_ms function.

Converts a UNIX day to a timestamp representing the start of the next day in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the next day (00:00:00.000).

Template Parameters

T	The return type of the function (default is ts_ms_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the next UNIX day.

Definition at line 202 of file time_conversion_aliases.hpp.

◆ ns_of_sec() [1/2]

int time_shield::ns_of_sec ( double ts )

Get the nanosecond part of a floating-point timestamp.

Parameters

ts	Timestamp in seconds with fractional part.

Returns: Nanoseconds of the second.

Definition at line 38 of file time_conversions.mqh.

◆ ns_of_sec() [2/2]

template<class T = int>

T time_shield::ns_of_sec ( fts_t ts )

constexprnoexcept

Get the nanosecond part of the second from a floating-point timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in floating-point seconds.

Returns: T Nanosecond part of the second.

Definition at line 31 of file time_conversions.hpp.

◆ num_days_in_month() [1/4]

int time_shield::num_days_in_month ( long ts )

Alias for num_days_in_month_ts.

Get the number of days in the month of the given timestamp.

This function calculates and returns the number of days in the month of the specified timestamp.

Parameters

ts	The timestamp to extract month and year from.

Returns: The number of days in the month of the given timestamp.

Definition at line 823 of file time_conversions.mqh.

◆ num_days_in_month() [2/4]

int time_shield::num_days_in_month	(	long	year,
		int	month )

Get the number of days in a month.

Parameters

year	Year value.
month	Month value.

Returns: Number of days in the month.

Definition at line 795 of file time_conversions.mqh.

◆ num_days_in_month() [3/4]

template<class T1 = int, class T2 = year_t, class T3 = int>

T1 time_shield::num_days_in_month	(	T2	year,
		T3	month )

constexprnoexcept

Get the number of days in a month.

This function calculates and returns the number of days in the specified month and year.

Parameters

year	Year as an integer.
month	Month as an integer.

Returns: The number of days in the given month and year.

Definition at line 1362 of file time_conversions.hpp.

◆ num_days_in_month() [4/4]

template<class T1 = int>

T1 time_shield::num_days_in_month ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for num_days_in_month_ts function.

Get the number of days in the month of the given timestamp.

This function calculates and returns the number of days in the month of the specified timestamp.

Parameters

ts	The timestamp to extract month and year from.

Returns: The number of days in the month of the given timestamp.

Definition at line 1591 of file time_conversion_aliases.hpp.

◆ num_days_in_month_ts() [1/2]

int time_shield::num_days_in_month_ts ( long ts )

Get the number of days in the month of a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Number of days in that month.

Definition at line 812 of file time_conversions.mqh.

◆ num_days_in_month_ts() [2/2]

template<class T1 = int>

TIME_SHIELD_CONSTEXPR T1 time_shield::num_days_in_month_ts ( ts_t ts = time_shield::ts() )

noexcept

Get the number of days in the month of the given timestamp.

This function calculates and returns the number of days in the month of the specified timestamp.

Parameters

ts	The timestamp to extract month and year from.

Returns: The number of days in the month of the given timestamp.

Definition at line 1381 of file time_conversions.hpp.

◆ num_days_in_year() [1/2]

int time_shield::num_days_in_year ( long year )

Get number of days in a year.

Parameters

year	Year value.

Returns: Days in the year.

Definition at line 832 of file time_conversions.mqh.

◆ num_days_in_year() [2/2]

template<class T1 = int, class T2 = year_t>

T1 time_shield::num_days_in_year ( T2 year )

constexprnoexcept

Get the number of days in a given year.

This function calculates and returns the number of days in the specified year.

Parameters

year Year.

Returns: Number of days in the given year.

Definition at line 1399 of file time_conversions.hpp.

◆ num_days_in_year_ts() [1/2]

int time_shield::num_days_in_year_ts ( long ts )

Get number of days in the year of the timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Days in the year of the timestamp.

Definition at line 844 of file time_conversions.mqh.

◆ num_days_in_year_ts() [2/2]

template<class T = int>

T time_shield::num_days_in_year_ts ( ts_t ts = time_shield::ts() )

constexpr

Get the number of days in the current year.

This function calculates and returns the number of days in the current year based on the provided timestamp.

Parameters

ts	Timestamp.

Returns: Number of days in the current year.

Definition at line 1413 of file time_conversions.hpp.

◆ previous_day_start() [1/2]

long time_shield::previous_day_start	(	long	ts,
		int	days = 1 )

Alias for start_of_prev_day.

Get timestamp of the start of the previous day.

This function returns the timestamp at the start of the previous day.

Parameters

ts	Timestamp of the current day.
days	Number of days to go back (default is 1).

Returns: Timestamp of the start of the previous day.

Definition at line 466 of file time_conversions.mqh.

◆ previous_day_start() [2/2]

template<class T = int>

ts_t time_shield::previous_day_start	(	ts_t	ts = time_shield::ts(),
		T	days = 1 )

constexprnoexcept

Alias for start_of_prev_day function.

Get timestamp of the start of the previous day.

This function returns the timestamp at the start of the previous day.

Parameters

ts	Timestamp of the current day.
days	Number of days to go back (default is 1).

Returns: Timestamp of the start of the previous day.

Definition at line 1633 of file time_conversion_aliases.hpp.

◆ saturday_begin() [1/2]

long time_shield::saturday_begin ( long ts )

Alias for start_of_saturday.

Get the timestamp of the start of Saturday.

This function finds the timestamp of the beginning of the day on Saturday, which corresponds to the start of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the start of Saturday.

Definition at line 1007 of file time_conversions.mqh.

◆ saturday_begin() [2/2]

ts_t time_shield::saturday_begin ( ts_t ts = time_shield::ts() )

constexpr

Alias for start_of_saturday function.

Get the timestamp of the start of Saturday.

This function finds the timestamp of the beginning of the day on Saturday, which corresponds to the start of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the start of Saturday.

Definition at line 1959 of file time_conversion_aliases.hpp.

◆ sec_of_day() [1/4]

int time_shield::sec_of_day	(	int	hour,
		int	min,
		int	sec )

Get second of day from hours, minutes and seconds.

Parameters

hour	Hour value.
min	Minute value.
sec	Second value.

Returns: Second of the day.

Definition at line 1271 of file time_conversions.mqh.

◆ sec_of_day() [2/4]

int time_shield::sec_of_day ( long ts )

Get second of day from timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Second of the day.

Definition at line 1255 of file time_conversions.mqh.

◆ sec_of_day() [3/4]

template<class T1 = int, class T2 = int>

T1 time_shield::sec_of_day	(	T2	hour,
		T2	min,
		T2	sec )

constexprnoexcept

Get the second of the day.

This function returns a value between 0 and MAX_SEC_PER_DAY representing the second of the day, given the hour, minute, and second.

Template Parameters

T1	The return type of the function (default is int).
T2	The type of the hour, minute, and second parameters (default is int).

Parameters

hour	Hour of the day.
min	Minute of the hour.
sec	Second of the minute.

Returns: Second of the day.

Definition at line 1017 of file time_conversions.hpp.

◆ sec_of_day() [4/4]

template<class T = int>

T time_shield::sec_of_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the second of the day.

This function returns a value from 0 to MAX_SEC_PER_DAY representing the second of the day.

Template Parameters

T	The return type of the function (default is int).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Second of the day.

Definition at line 990 of file time_conversions.hpp.

◆ sec_of_day_ms() [1/2]

int time_shield::sec_of_day_ms ( long ts_ms )

Get second of day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Second of the day.

Definition at line 1262 of file time_conversions.mqh.

◆ sec_of_day_ms() [2/2]

template<class T = int>

T time_shield::sec_of_day_ms ( ts_ms_t ts_ms )

constexprnoexcept

Get the second of the day from milliseconds timestamp.

This function returns a value from 0 to MAX_SEC_PER_DAY representing the second of the day, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is int).

Parameters

ts_ms Timestamp in milliseconds.

Returns: Second of the day.

Definition at line 1002 of file time_conversions.hpp.

◆ sec_of_hour()

template<class T = int>

T time_shield::sec_of_hour ( ts_t ts = time_shield::ts() )

constexpr

Get the second of the hour.

This function returns a value between 0 and 3599 representing the second of the hour.

Template Parameters

T	The return type of the function (default is int).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Second of the hour.

Definition at line 1044 of file time_conversions.hpp.

◆ sec_of_min()

template<class T = int>

T time_shield::sec_of_min ( ts_t ts = time_shield::ts() )

constexpr

Get the second of the minute.

This function returns a value between 0 and 59 representing the second of the minute.

Template Parameters

T	The return type of the function (default is int).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Second of the minute.

Definition at line 1032 of file time_conversions.hpp.

◆ sec_to_fhour() [1/2]

double time_shield::sec_to_fhour ( long sec )

Convert seconds to floating-point hours.

Parameters

sec	Seconds value.

Returns: Hours as double.

Definition at line 179 of file time_conversions.mqh.

◆ sec_to_fhour() [2/2]

template<class T = ts_t>

double time_shield::sec_to_fhour ( T ts )

constexprnoexcept

Converts a timestamp from seconds to floating-point hours.

Template Parameters

T	The type of the input timestamp (default is ts_t).

Parameters

ts	Timestamp in seconds.

Returns: double Timestamp in floating-point hours.

Definition at line 397 of file time_conversions.hpp.

◆ sec_to_fmin() [1/2]

double time_shield::sec_to_fmin ( long sec )

Convert seconds to floating-point minutes.

Parameters

sec	Seconds value.

Returns: Minutes as double.

Definition at line 133 of file time_conversions.mqh.

◆ sec_to_fmin() [2/2]

template<class T = ts_t>

double time_shield::sec_to_fmin ( T ts )

constexprnoexcept

Converts a timestamp from seconds to floating-point minutes.

Template Parameters

T	The type of the input timestamp (default is ts_t).

Parameters

ts	Timestamp in seconds.

Returns: double Timestamp in floating-point minutes.

Definition at line 263 of file time_conversions.hpp.

◆ sec_to_hour() [1/2]

int time_shield::sec_to_hour ( long sec )

Convert seconds to hours (integer part).

Parameters

sec	Seconds value.

Returns: Hours value.

Definition at line 165 of file time_conversions.mqh.

◆ sec_to_hour() [2/2]

template<class T1 = int, class T2 = ts_t>

T1 time_shield::sec_to_hour ( T2 ts )

constexprnoexcept

Converts a timestamp from seconds to hours.

Template Parameters

T1	The type of the output timestamp (default is int).
T2	The type of the input timestamp (default is ts_t).

Parameters

ts	Timestamp in seconds.

Returns: T1 Timestamp in hours.

Definition at line 379 of file time_conversions.hpp.

◆ sec_to_min() [1/2]

int time_shield::sec_to_min ( long sec )

Convert seconds to minutes (integer part).

Parameters

sec	Seconds value.

Returns: Minutes value.

Definition at line 119 of file time_conversions.mqh.

◆ sec_to_min() [2/2]

template<class T1 = int, class T2 = ts_t>

T1 time_shield::sec_to_min ( T2 ts )

constexprnoexcept

Converts a timestamp from seconds to minutes.

Template Parameters

T1	The type of the output timestamp (default is int).
T2	The type of the input timestamp (default is ts_t).

Parameters

ts	Timestamp in seconds.

Returns: T1 Timestamp in minutes.

Definition at line 245 of file time_conversions.hpp.

◆ sec_to_ms() [1/2]

long time_shield::sec_to_ms ( double sec )

Convert seconds to milliseconds.

Parameters

sec	Timestamp in seconds.

Returns: Milliseconds value.

Definition at line 73 of file time_conversions.mqh.

◆ sec_to_ms() [2/2]

template<class T1 = ts_ms_t, class T2>

T1 time_shield::sec_to_ms ( T2 ts )

constexprnoexcept

Converts a timestamp from seconds to milliseconds.

Template Parameters

T1	The type of the output timestamp (default is ts_ms_t).
T2	The type of the input timestamp.

Parameters

ts	Timestamp in seconds.

Returns: T1 Timestamp in milliseconds.

Definition at line 93 of file time_conversions.hpp.

◆ sec_to_ms_impl() [1/2]

template<class T>

ts_ms_t time_shield::sec_to_ms_impl	(	T	t,
		std::false_type	tag )

constexprnoexcept

Helper function for converting seconds to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in seconds.
tag	std::false_type indicates a non-floating-point type.

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 82 of file time_conversions.hpp.

◆ sec_to_ms_impl() [2/2]

template<class T>

ts_ms_t time_shield::sec_to_ms_impl	(	T	t,
		std::true_type	tag )

constexprnoexcept

Helper function for converting seconds to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in seconds.
tag	std::true_type indicates a floating-point type.

Returns: ts_ms_t Timestamp in milliseconds.

Definition at line 72 of file time_conversions.hpp.

◆ start_day_sec()

ts_t time_shield::start_day_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for start_of_day_sec function.

Get the start of the day timestamp in seconds.

This function returns the timestamp at the start of the day in seconds. The function sets the hours, minutes, and seconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in seconds.

Definition at line 1647 of file time_conversion_aliases.hpp.

◆ start_of_day() [1/2]

long time_shield::start_of_day ( long ts )

Get the start of the day for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 of the same day.

Definition at line 448 of file time_conversions.mqh.

◆ start_of_day() [2/2]

ts_t time_shield::start_of_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the start of the day timestamp.

This function returns the timestamp at the start of the day. The function sets the hours, minutes, and seconds to zero.

Parameters

ts	Timestamp.

Returns: Start of the day timestamp.

Definition at line 1427 of file time_conversions.hpp.

◆ start_of_day_from_unix_day() [1/2]

long time_shield::start_of_day_from_unix_day ( long uday )

Alias for unix_day_to_timestamp.

Convert UNIX day to timestamp in seconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day.

Definition at line 1152 of file time_conversions.mqh.

◆ start_of_day_from_unix_day() [2/2]

template<class T = ts_t>

T time_shield::start_of_day_from_unix_day ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp function.

Converts a UNIX day to a timestamp in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the specified UNIX day.

Definition at line 126 of file time_conversion_aliases.hpp.

◆ start_of_day_from_unix_day_ms() [1/2]

long time_shield::start_of_day_from_unix_day_ms ( long uday )

Alias for unix_day_to_timestamp_ms.

Convert UNIX day to timestamp in milliseconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day in milliseconds.

Definition at line 1175 of file time_conversions.mqh.

◆ start_of_day_from_unix_day_ms() [2/2]

template<class T = ts_t>

T time_shield::start_of_day_from_unix_day_ms ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp_ms function.

Converts a UNIX day to a timestamp in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the specified UNIX day.

Definition at line 156 of file time_conversion_aliases.hpp.

◆ start_of_day_ms() [1/2]

long time_shield::start_of_day_ms ( long ts_ms )

Get the start of the day for a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at 00:00:00.000 of the same day.

Definition at line 482 of file time_conversions.mqh.

◆ start_of_day_ms() [2/2]

ts_ms_t time_shield::start_of_day_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the start of the day timestamp in milliseconds.

This function returns the timestamp at the start of the day in milliseconds. The function sets the hours, minutes, seconds, and milliseconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in milliseconds.

Definition at line 1467 of file time_conversions.hpp.

◆ start_of_day_sec() [1/2]

long time_shield::start_of_day_sec ( long ts_ms )

Get the start of the day in seconds from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at 00:00:00 of the same day in seconds.

Definition at line 471 of file time_conversions.mqh.

◆ start_of_day_sec() [2/2]

ts_t time_shield::start_of_day_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the start of the day timestamp in seconds.

This function returns the timestamp at the start of the day in seconds. The function sets the hours, minutes, and seconds to zero.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of the day timestamp in seconds.

Definition at line 1454 of file time_conversions.hpp.

◆ start_of_hour() [1/2]

long time_shield::start_of_hour ( long ts )

Get the start of the hour for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at HH:00:00 of the same hour.

Definition at line 902 of file time_conversions.mqh.

◆ start_of_hour() [2/2]

ts_t time_shield::start_of_hour ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Timestamp at the start of the hour.

Definition at line 1681 of file time_conversions.hpp.

◆ start_of_hour_ms() [1/2]

long time_shield::start_of_hour_ms ( long ts_ms )

Get the start of the hour for a millisecond timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at HH:00:00.000 of the hour.

Definition at line 924 of file time_conversions.mqh.

◆ start_of_hour_ms() [2/2]

ts_ms_t time_shield::start_of_hour_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the start of the hour. This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in milliseconds.

Definition at line 1703 of file time_conversions.hpp.

◆ start_of_hour_sec() [1/2]

long time_shield::start_of_hour_sec ( long ts_ms )

Get the start of the hour in seconds from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at HH:00:00 of the hour in seconds.

Definition at line 913 of file time_conversions.mqh.

◆ start_of_hour_sec() [2/2]

ts_t time_shield::start_of_hour_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

constexprnoexcept

Get the timestamp at the start of the hour.

This function sets the minute and second to zero.

Parameters

ts_ms Timestamp in milliseconds (default: current timestamp in milliseconds).

Returns: Timestamp at the start of the hour in seconds.

Definition at line 1693 of file time_conversions.hpp.

◆ start_of_min() [1/2]

long time_shield::start_of_min ( long ts )

Get the start of the minute for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at mm:00 of the same minute.

Definition at line 1012 of file time_conversions.mqh.

◆ start_of_min() [2/2]

ts_t time_shield::start_of_min ( ts_t ts = time_shield::ts() )

constexprnoexcept

Get the timestamp of the beginning of the minute.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the minute.

Definition at line 1798 of file time_conversions.hpp.

◆ start_of_month() [1/2]

long time_shield::start_of_month ( long ts )

Get the timestamp at the start of the month.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 on the first day of the month.

Definition at line 856 of file time_conversions.mqh.

◆ start_of_month() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_of_month ( ts_t ts = time_shield::ts() )

inline

Get the timestamp at the start of the current month.

This function returns the timestamp at the start of the current month, setting the day to the first day of the month and the time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns: Timestamp at the start of the current month

Definition at line 1628 of file time_conversions.hpp.

◆ start_of_next_day() [1/2]

long time_shield::start_of_next_day	(	long	ts,
		int	days = 1 )

Get the start of the next day.

Parameters

ts	Timestamp in seconds.
days	Number of days ahead (default 1).

Returns: Timestamp at 00:00:00 of the next day.

Definition at line 494 of file time_conversions.mqh.

◆ start_of_next_day() [2/2]

template<class T = int>

ts_t time_shield::start_of_next_day	(	ts_t	ts,
		T	days = 1 )

constexprnoexcept

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp.

Parameters

ts	The current timestamp in seconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in seconds representing the beginning of the specified future day.

Definition at line 1482 of file time_conversions.hpp.

◆ start_of_next_day_from_unix_day() [1/2]

long time_shield::start_of_next_day_from_unix_day ( long uday )

Get start of next day timestamp from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in seconds.

Definition at line 1202 of file time_conversions.mqh.

◆ start_of_next_day_from_unix_day() [2/2]

template<class T = ts_ms_t>

T time_shield::start_of_next_day_from_unix_day ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp representing the start of the next day in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the next day (00:00:00).

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the next UNIX day.

Definition at line 949 of file time_conversions.hpp.

◆ start_of_next_day_from_unix_day_ms() [1/2]

long time_shield::start_of_next_day_from_unix_day_ms ( long uday )

Get start of next day timestamp in ms from UNIX day.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of next day in milliseconds.

Definition at line 1209 of file time_conversions.mqh.

◆ start_of_next_day_from_unix_day_ms() [2/2]

template<class T = ts_ms_t>

T time_shield::start_of_next_day_from_unix_day_ms ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp representing the start of the next day in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the next day (00:00:00.000).

Template Parameters

T	The return type of the function (default is ts_ms_t).

Parameters

unix_day The number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the next UNIX day.

Definition at line 962 of file time_conversions.hpp.

◆ start_of_next_day_ms() [1/2]

long time_shield::start_of_next_day_ms	(	long	ts_ms,
		int	days = 1 )

Get the start of the next day in milliseconds.

Parameters

ts_ms	Timestamp in milliseconds.
days	Number of days ahead (default 1).

Returns: Timestamp at 00:00:00.000 of the next day in milliseconds.

Definition at line 506 of file time_conversions.mqh.

◆ start_of_next_day_ms() [2/2]

template<class T = int>

ts_ms_t time_shield::start_of_next_day_ms	(	ts_ms_t	ts_ms,
		T	days = 1 )

constexprnoexcept

Get the timestamp of the start of the day after a specified number of days.

Calculates the timestamp for the beginning of the day after a specified number of days relative to the given timestamp in milliseconds.

Parameters

ts_ms	The current timestamp in milliseconds.
days	The number of days after the current day (default is 1).

Returns: The timestamp in milliseconds representing the beginning of the specified future day.

Definition at line 1497 of file time_conversions.hpp.

◆ start_of_period() [1/2]

long time_shield::start_of_period	(	int	p,
		long	ts )

Get the start of a period.

Parameters

p	Period length in seconds.
ts	Timestamp (default current). Use time_utils.ts().

Returns: Timestamp of the start of the period.

Definition at line 1053 of file time_conversions.mqh.

◆ start_of_period() [2/2]

template<class T = int>

ts_t time_shield::start_of_period	(	T	p,
		ts_t	ts = time_shield::ts() )

constexpr

Get the timestamp of the start of the period.

Parameters

p	Period duration in seconds.
ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the start of the period.

Definition at line 1840 of file time_conversions.hpp.

◆ start_of_prev_day() [1/2]

long time_shield::start_of_prev_day	(	long	ts,
		int	days = 1 )

Get the start of the previous day.

Parameters

ts	Timestamp in seconds.
days	Number of days to go back (default 1).

Returns: Timestamp at 00:00:00 of the previous day.

Definition at line 460 of file time_conversions.mqh.

◆ start_of_prev_day() [2/2]

template<class T = int>

ts_t time_shield::start_of_prev_day	(	ts_t	ts = time_shield::ts(),
		T	days = 1 )

constexprnoexcept

Get timestamp of the start of the previous day.

This function returns the timestamp at the start of the previous day.

Parameters

ts	Timestamp of the current day.
days	Number of days to go back (default is 1).

Returns: Timestamp of the start of the previous day.

Definition at line 1441 of file time_conversions.hpp.

◆ start_of_saturday() [1/2]

long time_shield::start_of_saturday ( long ts )

Get the start of Saturday for the week of the timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 on Saturday of the current week.

Definition at line 1001 of file time_conversions.mqh.

◆ start_of_saturday() [2/2]

ts_t time_shield::start_of_saturday ( ts_t ts = time_shield::ts() )

constexpr

Get the timestamp of the start of Saturday.

This function finds the timestamp of the beginning of the day on Saturday, which corresponds to the start of Saturday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the start of Saturday.

Definition at line 1789 of file time_conversions.hpp.

◆ start_of_week() [1/2]

long time_shield::start_of_week ( long ts )

Get the start of the week (Sunday).

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 on Sunday of the current week.

Definition at line 979 of file time_conversions.mqh.

◆ start_of_week() [2/2]

ts_t time_shield::start_of_week ( ts_t ts = time_shield::ts() )

constexpr

Get the timestamp of the beginning of the week.

This function finds the timestamp of the beginning of the week, which corresponds to the start of Sunday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the week.

Definition at line 1763 of file time_conversions.hpp.

◆ start_of_year() [1/2]

long time_shield::start_of_year ( long ts )

Get the start of the year for a timestamp.

Parameters

ts	Timestamp in seconds.

Returns: Timestamp at 00:00:00 on January 1st of the year.

Definition at line 639 of file time_conversions.mqh.

◆ start_of_year() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_of_year ( ts_t ts )

inlinenoexcept

Get the start of the year timestamp.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts	Timestamp.

Returns: Start of the year timestamp.

Definition at line 1085 of file time_conversions.hpp.

◆ start_of_year_date() [1/2]

long time_shield::start_of_year_date ( long year )

Get the timestamp for the start of the specified year.

Parameters

year	Year value.

Returns: Timestamp at 00:00:00 on January 1st of the given year.

Definition at line 680 of file time_conversions.mqh.

◆ start_of_year_date() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_of_year_date ( T year )

inline

Get the timestamp of the start of the year.

This function returns the timestamp at the start of the specified year.

Parameters

year Year.

Returns: Timestamp of the start of the year.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1162 of file time_conversions.hpp.

◆ start_of_year_date_ms() [1/2]

long time_shield::start_of_year_date_ms ( long year )

Get the timestamp in milliseconds for the start of the specified year.

Parameters

year	Year value.

Returns: Timestamp at 00:00:00 on January 1st in milliseconds.

Definition at line 709 of file time_conversions.mqh.

◆ start_of_year_date_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::start_of_year_date_ms ( T year )

inline

Get the timestamp in milliseconds of the start of the year.

This function returns the timestamp at the start of the specified year in milliseconds.

Parameters

year Year.

Returns: Timestamp of the start of the year in milliseconds.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1190 of file time_conversions.hpp.

◆ start_of_year_ms() [1/2]

long time_shield::start_of_year_ms ( long ts_ms )

Get the start of the year in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Timestamp at 00:00:00 on January 1st in milliseconds.

Definition at line 665 of file time_conversions.mqh.

◆ start_of_year_ms() [2/2]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::start_of_year_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inlinenoexcept

Get the start of the year timestamp in milliseconds.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of year timestamp in milliseconds.

Definition at line 1148 of file time_conversions.hpp.

◆ timestamp() [1/6]

ts_t time_shield::timestamp ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 740 of file time_conversion_aliases.hpp.

◆ timestamp() [2/6]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp ( const T & date_time )

inline

Alias for dt_to_timestamp function.

Converts a date-time structure to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 719 of file time_conversion_aliases.hpp.

◆ timestamp() [3/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp	(	year_t	year,
		int	month,
		int	day )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 537 of file time_conversion_aliases.hpp.

◆ timestamp() [4/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 557 of file time_conversion_aliases.hpp.

◆ timestamp() [5/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 578 of file time_conversion_aliases.hpp.

◆ timestamp() [6/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 600 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [1/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp_ms ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp_ms function.

Converts a std::tm structure to a timestamp in milliseconds.

This function converts a given std::tm structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp in milliseconds representing the given date and time.

Definition at line 1308 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [2/7]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp_ms ( const T & date_time )

inline

Alias for dt_to_timestamp_ms function.

Converts a date-time structure to a timestamp in milliseconds.

This function converts a given date-time structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1278 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [3/7]

ts_ms_t time_shield::timestamp_ms	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1068 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [4/7]

ts_ms_t time_shield::timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1086 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [5/7]

ts_ms_t time_shield::timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1105 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [6/7]

ts_ms_t time_shield::timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1125 of file time_conversion_aliases.hpp.

◆ timestamp_ms() [7/7]

ts_ms_t time_shield::timestamp_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec,
		int	ms )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.
ms	The millisecond value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1146 of file time_conversion_aliases.hpp.

◆ tm_to_ftimestamp()

TIME_SHIELD_CONSTEXPR fts_t time_shield::tm_to_ftimestamp ( const std::tm * timeinfo )

inline

Converts a std::tm structure to a floating-point timestamp.

This function converts a given std::tm structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to the std::tm structure containing the date and time.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 834 of file time_conversions.hpp.

◆ tm_to_timestamp()

TIME_SHIELD_CONSTEXPR ts_t time_shield::tm_to_timestamp ( const std::tm * timeinfo )

inline

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 696 of file time_conversions.hpp.

◆ tm_to_timestamp_ms()

TIME_SHIELD_CONSTEXPR ts_t time_shield::tm_to_timestamp_ms ( const std::tm * timeinfo )

inline

Converts a std::tm structure to a timestamp in milliseconds.

This function converts a given std::tm structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp in milliseconds representing the given date and time.

Definition at line 765 of file time_conversions.hpp.

◆ to_date_time() [1/2]

DateTimeStruct time_shield::to_date_time ( long ts )

Convert a timestamp to a DateTimeStruct.

Parameters

ts	Timestamp in seconds since UNIX epoch.

Returns: Filled DateTimeStruct.

Definition at line 274 of file time_conversions.mqh.

◆ to_date_time() [2/2]

template<class T1 = DateTimeStruct, class T2 = ts_t>

T1 time_shield::to_date_time ( T2 ts )

Converts a timestamp to a date-time structure.

This function converts a timestamp (usually an integer representing seconds since epoch) to a custom date-time structure. The default type for the timestamp is int64_t.

Template Parameters

T1	The date-time structure type to be returned.
T2	The type of the timestamp (default is int64_t).

Parameters

ts	The timestamp to be converted.

Returns: A date-time structure of type T1.

Definition at line 463 of file time_conversions.hpp.

◆ to_date_time_mql()

MqlDateTime time_shield::to_date_time_mql ( long ts )

Convert a timestamp to the standard MqlDateTime structure.

Parameters

ts	Timestamp in seconds since UNIX epoch.

Returns: Filled MqlDateTime structure.

Definition at line 295 of file time_conversions.mqh.

◆ to_date_time_ms() [1/2]

DateTimeStruct time_shield::to_date_time_ms ( long ts_ms )

Convert a timestamp in milliseconds to DateTimeStruct.

Parameters

ts_ms Timestamp in milliseconds since UNIX epoch.

Returns: Filled DateTimeStruct with millisecond part.

Definition at line 308 of file time_conversions.mqh.

◆ to_date_time_ms() [2/2]

template<class T>

T time_shield::to_date_time_ms ( ts_ms_t ts )

inline

Converts a timestamp in milliseconds to a date-time structure with milliseconds.

Template Parameters

T	The type of the date-time structure to return.

Parameters

ts	The timestamp in milliseconds to convert.

Returns: T A date-time structure with the corresponding date and time components.

Definition at line 568 of file time_conversions.hpp.

◆ to_dt() [1/2]

DateTimeStruct time_shield::to_dt ( long ts )

Alias for to_date_time.

Converts a timestamp to a date-time structure.

This function converts a timestamp (usually an integer representing seconds since epoch) to a custom date-time structure. The default type for the timestamp is int64_t.

Template Parameters

T1	The date-time structure type to be returned.
T2	The type of the timestamp (default is int64_t).

Parameters

ts	The timestamp to be converted.

Returns: A date-time structure of type T1.

Definition at line 290 of file time_conversions.mqh.

◆ to_dt() [2/2]

template<class T1, class T2 = ts_t>

T1 time_shield::to_dt ( T2 ts )

Alias for to_date_time function.

Converts a timestamp to a date-time structure.

This function converts a timestamp (usually an integer representing seconds since epoch) to a custom date-time structure. The default type for the timestamp is int64_t.

Template Parameters

T1	The date-time structure type to be returned.
T2	The type of the timestamp (default is int64_t).

Parameters

ts	The timestamp to be converted.

Returns: A date-time structure of type T1.

Definition at line 244 of file time_conversion_aliases.hpp.

◆ to_dt_ms() [1/2]

DateTimeStruct time_shield::to_dt_ms ( long ts_ms )

Alias for to_date_time_ms.

Convert a timestamp in milliseconds to DateTimeStruct.

Parameters

ts_ms Timestamp in milliseconds since UNIX epoch.

Returns: Filled DateTimeStruct with millisecond part.

Definition at line 316 of file time_conversions.mqh.

◆ to_dt_ms() [2/2]

template<class T>

T time_shield::to_dt_ms ( ts_ms_t ts )

inline

Alias for to_date_time_ms function.

Converts a timestamp in milliseconds to a date-time structure with milliseconds.

Template Parameters

T	The type of the date-time structure to return.

Parameters

ts	The timestamp in milliseconds to convert.

Returns: T A date-time structure with the corresponding date and time components.

Definition at line 262 of file time_conversion_aliases.hpp.

◆ to_dt_struct()

template<class T1, class T2 = ts_t>

T1 time_shield::to_dt_struct ( T2 ts )

Alias for to_date_time function.

Converts a timestamp to a date-time structure.

This function converts a timestamp (usually an integer representing seconds since epoch) to a custom date-time structure. The default type for the timestamp is int64_t.

Template Parameters

T1	The date-time structure type to be returned.
T2	The type of the timestamp (default is int64_t).

Parameters

ts	The timestamp to be converted.

Returns: A date-time structure of type T1.

Definition at line 252 of file time_conversion_aliases.hpp.

◆ to_dt_struct_ms()

template<class T>

T time_shield::to_dt_struct_ms ( ts_ms_t ts )

inline

Alias for to_date_time_ms function.

Converts a timestamp in milliseconds to a date-time structure with milliseconds.

Template Parameters

T	The type of the date-time structure to return.

Parameters

ts	The timestamp in milliseconds to convert.

Returns: T A date-time structure with the corresponding date and time components.

Definition at line 270 of file time_conversion_aliases.hpp.

◆ to_ftimestamp() [1/5]

double time_shield::to_ftimestamp ( const DateTimeStruct & dt )

Alias for dt_to_ftimestamp.

Convert a DateTimeStruct to floating-point timestamp.

Parameters

dt	Structure with date and time fields.

Returns: Floating-point timestamp.

Definition at line 435 of file time_conversions.mqh.

◆ to_ftimestamp() [2/5]

double time_shield::to_ftimestamp ( const MqlDateTime & dt )

Alias for dt_to_ftimestamp.

Convert an MqlDateTime structure to floating-point timestamp.

Parameters

dt	Standard MqlDateTime structure.

Returns: Floating-point timestamp.

Definition at line 439 of file time_conversions.mqh.

◆ to_ftimestamp() [3/5]

fts_t time_shield::to_ftimestamp ( const std::tm * timeinfo )

constexpr

Alias for tm_to_ftimestamp.

Converts a std::tm structure to a floating-point timestamp.

This function converts a given std::tm structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to the std::tm structure containing the date and time.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1426 of file time_conversion_aliases.hpp.

◆ to_ftimestamp() [4/5]

template<class T>

fts_t time_shield::to_ftimestamp ( const T & date_time )

constexpr

Alias for dt_to_ftimestamp.

Converts a date-time structure to a floating-point timestamp.

This function converts a given date and time structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure containing year, month, day, hour, minute, second, and millisecond fields.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1393 of file time_conversion_aliases.hpp.

◆ to_ftimestamp() [5/5]

template<class T1 = year_t, class T2 = int, class T3 = int>

TIME_SHIELD_CONSTEXPR fts_t time_shield::to_ftimestamp	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0,
		T3	ms = 0 )

inline

Converts a date and time to a floating-point timestamp.

This function converts a given date and time to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is year_t).
T2	The type of the month, day, hour, minute, and second parameters (default is int).
T3	The type of the millisecond parameter (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).
ms	The millisecond value (default is 0).

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 791 of file time_conversions.hpp.

◆ to_fts() [1/3]

fts_t time_shield::to_fts ( const std::tm * timeinfo )

constexpr

Alias for tm_to_ftimestamp.

Converts a std::tm structure to a floating-point timestamp.

This function converts a given std::tm structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to the std::tm structure containing the date and time.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1433 of file time_conversion_aliases.hpp.

◆ to_fts() [2/3]

template<class T>

fts_t time_shield::to_fts ( const T & date_time )

constexpr

Alias for dt_to_ftimestamp.

Converts a date-time structure to a floating-point timestamp.

This function converts a given date and time structure to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure containing year, month, day, hour, minute, second, and millisecond fields.

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1401 of file time_conversion_aliases.hpp.

◆ to_fts() [3/3]

template<class T1 = year_t, class T2 = int, class T3 = int>

fts_t time_shield::to_fts	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0,
		T3	ms = 0 )

constexpr

Alias for to_ftimestamp.

This function converts a given date and time to a floating-point timestamp, which is the number of seconds (with fractional milliseconds) since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is year_t).
T2	The type of the month, day, hour, minute, and second parameters (default is int).
T3	The type of the millisecond parameter (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).
ms	The millisecond value (default is 0).

Returns: Floating-point timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_ftimestamp

Definition at line 1335 of file time_conversion_aliases.hpp.

◆ to_mql_dt()

MqlDateTime time_shield::to_mql_dt ( long ts )

Alias for to_date_time_mql.

Convert a timestamp to the standard MqlDateTime structure.

Parameters

ts	Timestamp in seconds since UNIX epoch.

Returns: Filled MqlDateTime structure.

Definition at line 303 of file time_conversions.mqh.

◆ to_time_zone() [1/2]

TimeZoneStruct time_shield::to_time_zone ( int offset )

Convert an integer offset to a TimeZoneStruct.

Parameters

offset Offset in seconds.

Returns: TimeZoneStruct represented by the offset.

Definition at line 1278 of file time_conversions.mqh.

◆ to_time_zone() [2/2]

template<class T = TimeZoneStruct>

T time_shield::to_time_zone ( tz_t offset )

inline

Converts an integer to a time zone structure.

Template Parameters

T	The type of the time zone structure (default is TimeZoneStruct).

Parameters

offset The integer to convert.

Returns: A time zone structure of type T represented by the given integer.

The function assumes that the type T has members hour, min, and is_positive.

Definition at line 1863 of file time_conversions.hpp.

◆ to_timestamp() [1/6]

long time_shield::to_timestamp ( const DateTimeStruct & dt )

Alias for dt_to_timestamp.

Convert a DateTimeStruct to timestamp.

Parameters

dt	Structure with date and time fields.

Returns: Timestamp in seconds.

Definition at line 341 of file time_conversions.mqh.

◆ to_timestamp() [2/6]

long time_shield::to_timestamp ( const MqlDateTime & dt )

Alias for dt_to_timestamp taking MqlDateTime.

Convert an MqlDateTime structure to timestamp.

Parameters

dt	Standard MqlDateTime structure.

Returns: Timestamp in seconds.

Definition at line 345 of file time_conversions.mqh.

◆ to_timestamp() [3/6]

ts_t time_shield::to_timestamp ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 764 of file time_conversion_aliases.hpp.

◆ to_timestamp() [4/6]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_timestamp ( const T & date_time )

inline

Alias for dt_to_timestamp function.

Converts a date-time structure to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 692 of file time_conversion_aliases.hpp.

◆ to_timestamp() [5/6]

long time_shield::to_timestamp	(	long	year,
		int	mon,
		int	day,
		int	hour = 0,
		int	min = 0,
		int	sec = 0 )

Convert date and time values to a timestamp.

Parameters

year	Year value.
mon	Month value.
day	Day value.
hour	Hour value.
min	Minute value.
sec	Second value.

Returns: Timestamp in seconds.

Definition at line 355 of file time_conversions.mqh.

◆ to_timestamp() [6/6]

template<class T1 = year_t, class T2 = int>

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_timestamp	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0 )

inline

Converts a date and time to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Aliases:

The following function names are provided as aliases:

ts(...)
get_ts(...)
get_timestamp(...)
timestamp(...)
to_ts(...)

These aliases are macro-generated and behave identically to to_timestamp.

See also: ts(); get_ts(); get_timestamp(); timestamp(); to_ts()

Definition at line 607 of file time_conversions.hpp.

◆ to_timestamp_ms() [1/6]

long time_shield::to_timestamp_ms ( const DateTimeStruct & dt )

Alias for dt_to_timestamp_ms.

Convert a DateTimeStruct to a timestamp in milliseconds.

Parameters

dt	Structure with date and time fields.

Returns: Timestamp in milliseconds.

Definition at line 413 of file time_conversions.mqh.

◆ to_timestamp_ms() [2/6]

long time_shield::to_timestamp_ms ( const MqlDateTime & dt )

Alias for dt_to_timestamp_ms.

Convert an MqlDateTime structure to a timestamp in milliseconds.

Parameters

dt	Standard MqlDateTime structure.

Returns: Timestamp in milliseconds.

Definition at line 417 of file time_conversions.mqh.

◆ to_timestamp_ms() [3/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_timestamp_ms ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp_ms function.

Converts a std::tm structure to a timestamp in milliseconds.

This function converts a given std::tm structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp in milliseconds representing the given date and time.

Definition at line 1287 of file time_conversion_aliases.hpp.

◆ to_timestamp_ms() [4/6]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_timestamp_ms ( const T & date_time )

inline

Alias for dt_to_timestamp_ms function.

Converts a date-time structure to a timestamp in milliseconds.

This function converts a given date-time structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1251 of file time_conversion_aliases.hpp.

◆ to_timestamp_ms() [5/6]

long time_shield::to_timestamp_ms	(	long	year,
		int	mon,
		int	day,
		int	hour = 0,
		int	min = 0,
		int	sec = 0,
		int	ms = 0 )

Convert date and time values to a timestamp in milliseconds.

Parameters

year	Year value.
mon	Month value.
day	Day value.
hour	Hour value.
min	Minute value.
sec	Second value.
ms	Millisecond value.

Returns: Timestamp in milliseconds.

Definition at line 381 of file time_conversions.mqh.

◆ to_timestamp_ms() [6/6]

template<class T1 = year_t, class T2 = int>

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::to_timestamp_ms	(	T1	year,
		T2	month,
		T2	day,
		T2	hour = 0,
		T2	min = 0,
		T2	sec = 0,
		T2	ms = 0 )

inline

Converts a date and time to a timestamp in milliseconds.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value (default is 0).
min	The minute value (default is 0).
sec	The second value (default is 0).
ms	The millisecond value (default is 0).

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 726 of file time_conversions.hpp.

◆ to_ts() [1/7]

ts_t time_shield::to_ts ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 752 of file time_conversion_aliases.hpp.

◆ to_ts() [2/7]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts ( const T & date_time )

inline

Alias for dt_to_timestamp function.

Converts a date-time structure to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 701 of file time_conversion_aliases.hpp.

◆ to_ts() [3/7]

long time_shield::to_ts	(	long	year,
		int	mon,
		int	day,
		int	hour = 0,
		int	min = 0,
		int	sec = 0 )

Alias for to_timestamp with explicit date fields.

Convert date and time values to a timestamp.

Parameters

year	Year value.
mon	Month value.
day	Day value.
hour	Hour value.
min	Minute value.
sec	Second value.

Returns: Timestamp in seconds.

Definition at line 368 of file time_conversions.mqh.

◆ to_ts() [4/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts	(	year_t	year,
		int	month,
		int	day )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 619 of file time_conversion_aliases.hpp.

◆ to_ts() [5/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 639 of file time_conversion_aliases.hpp.

◆ to_ts() [6/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 660 of file time_conversion_aliases.hpp.

◆ to_ts() [7/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 682 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [1/8]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts_ms ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp_ms function.

Converts a std::tm structure to a timestamp in milliseconds.

This function converts a given std::tm structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp in milliseconds representing the given date and time.

Definition at line 1294 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [2/8]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts_ms ( const T & date_time )

inline

Alias for dt_to_timestamp_ms function.

Converts a date-time structure to a timestamp in milliseconds.

This function converts a given date-time structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1260 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [3/8]

long time_shield::to_ts_ms	(	long	year,
		int	mon,
		int	day,
		int	hour = 0,
		int	min = 0,
		int	sec = 0,
		int	ms = 0 )

Alias for to_timestamp_ms.

Convert date and time values to a timestamp in milliseconds.

Parameters

year	Year value.
mon	Month value.
day	Day value.
hour	Hour value.
min	Minute value.
sec	Second value.
ms	Millisecond value.

Returns: Timestamp in milliseconds.

Definition at line 387 of file time_conversions.mqh.

◆ to_ts_ms() [4/8]

ts_ms_t time_shield::to_ts_ms	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1163 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [5/8]

ts_ms_t time_shield::to_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1181 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [6/8]

ts_ms_t time_shield::to_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1200 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [7/8]

ts_ms_t time_shield::to_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1220 of file time_conversion_aliases.hpp.

◆ to_ts_ms() [8/8]

ts_ms_t time_shield::to_ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec,
		int	ms )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.
ms	The millisecond value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 1241 of file time_conversion_aliases.hpp.

◆ to_tz_struct()

TimeZoneStruct time_shield::to_tz_struct ( int offset )

Alias for to_time_zone.

Converts an integer to a time zone structure.

Template Parameters

T	The type of the time zone structure (default is TimeZoneStruct).

Parameters

offset The integer to convert.

Returns: A time zone structure of type T represented by the given integer.

The function assumes that the type T has members hour, min, and is_positive.

Definition at line 1284 of file time_conversions.mqh.

◆ to_unix_min() [1/2]

long time_shield::to_unix_min ( long ts )

Alias for get_unix_min.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 1246 of file time_conversions.mqh.

◆ to_unix_min() [2/2]

template<class T = int64_t>

T time_shield::to_unix_min ( ts_t ts = time_shield::ts() )

constexpr

Alias for get_unix_min function.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 218 of file time_conversion_aliases.hpp.

◆ to_unix_year() [1/2]

long time_shield::to_unix_year ( long ts )

Alias for get_unix_year function.

Converts a UNIX timestamp to a year.

Template Parameters

T	The type of the year (default is year_t).

Parameters

ts	UNIX timestamp.

Returns: T Year corresponding to the given timestamp.

Definition at line 235 of file time_conversions.mqh.

◆ to_unix_year() [2/2]

template<class T = year_t>

T time_shield::to_unix_year ( ts_t ts )

constexprnoexcept

Alias for get_unix_year function.

Converts a UNIX timestamp to a year.

Template Parameters

T	The type of the year (default is year_t).

Parameters

ts	UNIX timestamp.

Returns: T Year corresponding to the given timestamp.

Definition at line 28 of file time_conversion_aliases.hpp.

◆ to_year() [1/2]

long time_shield::to_year ( long ts )

Alias for get_year.

Get the year from the timestamp.

This function returns the year of the specified timestamp in seconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 250 of file time_conversions.mqh.

◆ to_year() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::to_year ( ts_t ts = time_shield::ts() )

inline

Alias for get_year function.

Get the year from the timestamp.

This function returns the year of the specified timestamp in seconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1479 of file time_conversion_aliases.hpp.

◆ to_year_ms() [1/2]

long time_shield::to_year_ms ( long ts_ms )

Alias for get_year_ms.

Get the year from the timestamp in milliseconds.

This function returns the year of the specified timestamp in milliseconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts_ms Timestamp in milliseconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 265 of file time_conversions.mqh.

◆ to_year_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::to_year_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Alias for get_year_ms function.

Get the year from the timestamp in milliseconds.

This function returns the year of the specified timestamp in milliseconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts_ms Timestamp in milliseconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1495 of file time_conversion_aliases.hpp.

◆ ts() [1/6]

ts_t time_shield::ts ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 728 of file time_conversion_aliases.hpp.

◆ ts() [2/6]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts ( const T & date_time )

inline

Alias for dt_to_timestamp function.

Converts a date-time structure to a timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 710 of file time_conversion_aliases.hpp.

◆ ts() [3/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts	(	year_t	year,
		int	month,
		int	day )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 291 of file time_conversion_aliases.hpp.

◆ ts() [4/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts	(	year_t	year,
		int	month,
		int	day,
		int	hour )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 311 of file time_conversion_aliases.hpp.

◆ ts() [5/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 332 of file time_conversion_aliases.hpp.

◆ ts() [6/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

inline

Alias for to_timestamp.

This function converts a given date and time to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

If the day is ≥ 1970 and year ≤ 31, parameters are assumed to be in DD-MM-YYYY order and are automatically reordered.

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp

Definition at line 354 of file time_conversion_aliases.hpp.

◆ ts_from_tm()

ts_t time_shield::ts_from_tm ( const std::tm * timeinfo )

constexpr

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a standard C++ std::tm structure to a timestamp, which is the number of seconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 758 of file time_conversion_aliases.hpp.

◆ ts_ms() [1/8]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts_ms ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp_ms function.

Converts a std::tm structure to a timestamp in milliseconds.

This function converts a given std::tm structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Parameters

timeinfo Pointer to a std::tm structure containing the date and time information.

Returns: Timestamp in milliseconds representing the given date and time.

Definition at line 1301 of file time_conversion_aliases.hpp.

◆ ts_ms() [2/8]

template<class T>

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts_ms ( const T & date_time )

inline

Alias for dt_to_timestamp_ms function.

Converts a date-time structure to a timestamp in milliseconds.

This function converts a given date-time structure to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T	The type of the date-time structure.

Parameters

date_time The date-time structure.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1269 of file time_conversion_aliases.hpp.

◆ ts_ms() [3/8]

long time_shield::ts_ms	(	long	year,
		int	mon,
		int	day,
		int	hour = 0,
		int	min = 0,
		int	sec = 0,
		int	ms = 0 )

Alias for to_timestamp_ms.

Convert date and time values to a timestamp in milliseconds.

Parameters

year	Year value.
mon	Month value.
day	Day value.
hour	Hour value.
min	Minute value.
sec	Second value.
ms	Millisecond value.

Returns: Timestamp in milliseconds.

Definition at line 393 of file time_conversions.mqh.

◆ ts_ms() [4/8]

ts_ms_t time_shield::ts_ms	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 783 of file time_conversion_aliases.hpp.

◆ ts_ms() [5/8]

ts_ms_t time_shield::ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 801 of file time_conversion_aliases.hpp.

◆ ts_ms() [6/8]

ts_ms_t time_shield::ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 820 of file time_conversion_aliases.hpp.

◆ ts_ms() [7/8]

ts_ms_t time_shield::ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 840 of file time_conversion_aliases.hpp.

◆ ts_ms() [8/8]

ts_ms_t time_shield::ts_ms	(	year_t	year,
		int	month,
		int	day,
		int	hour,
		int	min,
		int	sec,
		int	ms )

constexpr

Alias for to_timestamp_ms.

This function converts a given date and time to a timestamp in milliseconds, which is the number of milliseconds since the Unix epoch (January 1, 1970).

Template Parameters

T1	The type of the year parameter (default is int64_t).
T2	The type of the other date and time parameters (default is int).

Parameters

year	The year value.
month	The month value.
day	The day value.
hour	The hour value.
min	The minute value.
sec	The second value.
ms	The millisecond value.

Returns: Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument if the date-time combination is invalid.

See also: to_timestamp_ms

Definition at line 861 of file time_conversion_aliases.hpp.

◆ uday() [1/2]

long time_shield::uday ( long ts )

Alias for get_unix_day.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 1090 of file time_conversions.mqh.

◆ uday() [2/2]

template<class T = uday_t>

T time_shield::uday ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for get_unix_day function.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 62 of file time_conversion_aliases.hpp.

◆ uday_ms() [1/2]

long time_shield::uday_ms ( long ts_ms )

Alias for get_unix_day_ms.

Get UNIX day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Number of days since UNIX epoch.

Definition at line 1129 of file time_conversions.mqh.

◆ uday_ms() [2/2]

template<class T = uday_t>

T time_shield::uday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for get_unix_day_ms function.

Get UNIX day from milliseconds timestamp.

This function returns the number of days elapsed since the UNIX epoch, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

t_ms	Timestamp in milliseconds (default is current timestamp in milliseconds).

Returns: Number of days since the UNIX epoch.

Definition at line 96 of file time_conversion_aliases.hpp.

◆ uday_to_ts() [1/2]

long time_shield::uday_to_ts ( long uday )

Alias for unix_day_to_timestamp.

Convert UNIX day to timestamp in seconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day.

Definition at line 1148 of file time_conversions.mqh.

◆ uday_to_ts() [2/2]

template<class T = ts_t>

T time_shield::uday_to_ts ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp function.

Converts a UNIX day to a timestamp in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the specified UNIX day.

Definition at line 119 of file time_conversion_aliases.hpp.

◆ uday_to_ts_ms() [1/2]

long time_shield::uday_to_ts_ms ( long uday )

Alias for unix_day_to_timestamp_ms.

Convert UNIX day to timestamp in milliseconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day in milliseconds.

Definition at line 1171 of file time_conversions.mqh.

◆ uday_to_ts_ms() [2/2]

template<class T = ts_t>

T time_shield::uday_to_ts_ms ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp_ms function.

Converts a UNIX day to a timestamp in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the specified UNIX day.

Definition at line 149 of file time_conversion_aliases.hpp.

◆ umin() [1/2]

long time_shield::umin ( long ts )

Alias for get_unix_min.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 1250 of file time_conversions.mqh.

◆ umin() [2/2]

template<class T = int64_t>

T time_shield::umin ( ts_t ts = time_shield::ts() )

constexpr

Alias for get_unix_min function.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 225 of file time_conversion_aliases.hpp.

◆ unix_day() [1/2]

long time_shield::unix_day ( long ts )

Alias for get_unix_day.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 1078 of file time_conversions.mqh.

◆ unix_day() [2/2]

template<class T = uday_t>

T time_shield::unix_day ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for get_unix_day function.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 46 of file time_conversion_aliases.hpp.

◆ unix_day_ms() [1/2]

long time_shield::unix_day_ms ( long ts_ms )

Alias for get_unix_day_ms.

Get UNIX day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Number of days since UNIX epoch.

Definition at line 1117 of file time_conversions.mqh.

◆ unix_day_ms() [2/2]

template<class T = uday_t>

T time_shield::unix_day_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for get_unix_day_ms function.

Get UNIX day from milliseconds timestamp.

This function returns the number of days elapsed since the UNIX epoch, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

t_ms	Timestamp in milliseconds (default is current timestamp in milliseconds).

Returns: Number of days since the UNIX epoch.

Definition at line 80 of file time_conversion_aliases.hpp.

◆ unix_day_to_timestamp() [1/2]

long time_shield::unix_day_to_timestamp ( long uday )

Convert UNIX day to timestamp in seconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day.

Definition at line 1134 of file time_conversions.mqh.

◆ unix_day_to_timestamp() [2/2]

template<class T = ts_t>

T time_shield::unix_day_to_timestamp ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the specified UNIX day.

Definition at line 893 of file time_conversions.hpp.

◆ unix_day_to_timestamp_ms() [1/2]

long time_shield::unix_day_to_timestamp_ms ( long uday )

Convert UNIX day to timestamp in milliseconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day in milliseconds.

Definition at line 1157 of file time_conversions.mqh.

◆ unix_day_to_timestamp_ms() [2/2]

template<class T = ts_t>

T time_shield::unix_day_to_timestamp_ms ( uday_t unix_day )

constexprnoexcept

Converts a UNIX day to a timestamp in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the specified UNIX day.

Definition at line 908 of file time_conversions.hpp.

◆ unix_day_to_ts() [1/2]

long time_shield::unix_day_to_ts ( long uday )

Alias for unix_day_to_timestamp.

Convert UNIX day to timestamp in seconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day.

Definition at line 1140 of file time_conversions.mqh.

◆ unix_day_to_ts() [2/2]

template<class T = ts_t>

T time_shield::unix_day_to_ts ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp function.

Converts a UNIX day to a timestamp in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the specified UNIX day.

Definition at line 105 of file time_conversion_aliases.hpp.

◆ unix_day_to_ts_ms() [1/2]

long time_shield::unix_day_to_ts_ms ( long uday )

Alias for unix_day_to_timestamp_ms.

Convert UNIX day to timestamp in milliseconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day in milliseconds.

Definition at line 1163 of file time_conversions.mqh.

◆ unix_day_to_ts_ms() [2/2]

template<class T = ts_t>

T time_shield::unix_day_to_ts_ms ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp_ms function.

Converts a UNIX day to a timestamp in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the specified UNIX day.

Definition at line 135 of file time_conversion_aliases.hpp.

◆ unix_min() [1/2]

long time_shield::unix_min ( long ts )

Alias for get_unix_min.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 1242 of file time_conversions.mqh.

◆ unix_min() [2/2]

template<class T = int64_t>

T time_shield::unix_min ( ts_t ts = time_shield::ts() )

constexpr

Alias for get_unix_min function.

Get UNIX minute.

This function returns the number of minutes elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is int64_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of minutes since the UNIX epoch.

Definition at line 211 of file time_conversion_aliases.hpp.

◆ unix_year() [1/2]

long time_shield::unix_year ( long ts )

Alias for get_unix_year function.

Converts a UNIX timestamp to a year.

Template Parameters

T	The type of the year (default is year_t).

Parameters

ts	UNIX timestamp.

Returns: T Year corresponding to the given timestamp.

Definition at line 231 of file time_conversions.mqh.

◆ unix_year() [2/2]

template<class T = year_t>

T time_shield::unix_year ( ts_t ts )

constexprnoexcept

Alias for get_unix_year function.

Converts a UNIX timestamp to a year.

Template Parameters

T	The type of the year (default is year_t).

Parameters

ts	UNIX timestamp.

Returns: T Year corresponding to the given timestamp.

Definition at line 21 of file time_conversion_aliases.hpp.

◆ unixday() [1/2]

long time_shield::unixday ( long ts )

Alias for get_unix_day.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 1086 of file time_conversions.mqh.

◆ unixday() [2/2]

template<class T = uday_t>

T time_shield::unixday ( ts_t ts = time_shield::ts() )

constexprnoexcept

Alias for get_unix_day function.

Get UNIX day.

This function returns the number of days elapsed since the UNIX epoch.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Number of days since the UNIX epoch.

Definition at line 54 of file time_conversion_aliases.hpp.

◆ unixday_ms() [1/2]

long time_shield::unixday_ms ( long ts_ms )

Alias for get_unix_day_ms.

Get UNIX day from milliseconds timestamp.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Number of days since UNIX epoch.

Definition at line 1125 of file time_conversions.mqh.

◆ unixday_ms() [2/2]

template<class T = uday_t>

T time_shield::unixday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

constexprnoexcept

Alias for get_unix_day_ms function.

Get UNIX day from milliseconds timestamp.

This function returns the number of days elapsed since the UNIX epoch, given a timestamp in milliseconds.

Template Parameters

T	The return type of the function (default is unixday_t).

Parameters

t_ms	Timestamp in milliseconds (default is current timestamp in milliseconds).

Returns: Number of days since the UNIX epoch.

Definition at line 88 of file time_conversion_aliases.hpp.

◆ unixday_to_ts() [1/2]

long time_shield::unixday_to_ts ( long uday )

Alias for unix_day_to_timestamp.

Convert UNIX day to timestamp in seconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day.

Definition at line 1144 of file time_conversions.mqh.

◆ unixday_to_ts() [2/2]

template<class T = ts_t>

T time_shield::unixday_to_ts ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp function.

Converts a UNIX day to a timestamp in seconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in seconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in seconds representing the beginning of the specified UNIX day.

Definition at line 112 of file time_conversion_aliases.hpp.

◆ unixday_to_ts_ms() [1/2]

long time_shield::unixday_to_ts_ms ( long uday )

Alias for unix_day_to_timestamp_ms.

Convert UNIX day to timestamp in milliseconds.

Parameters

uday	UNIX day value.

Returns: Timestamp at start of the day in milliseconds.

Definition at line 1167 of file time_conversions.mqh.

◆ unixday_to_ts_ms() [2/2]

template<class T = ts_t>

T time_shield::unixday_to_ts_ms ( uday_t unix_day )

constexprnoexcept

Alias for unix_day_to_timestamp_ms function.

Converts a UNIX day to a timestamp in milliseconds.

Converts a number of days since the UNIX epoch (January 1, 1970) to the corresponding timestamp in milliseconds at the start of the specified day.

Template Parameters

T	The return type of the function (default is ts_t).

Parameters

unix_day Number of days since the UNIX epoch.

Returns: The timestamp in milliseconds representing the beginning of the specified UNIX day.

Definition at line 142 of file time_conversion_aliases.hpp.

◆ us_of_sec() [1/2]

int time_shield::us_of_sec ( double ts )

Get the microsecond part of a floating-point timestamp.

Parameters

ts	Timestamp in seconds with fractional part.

Returns: Microseconds of the second.

Definition at line 46 of file time_conversions.mqh.

◆ us_of_sec() [2/2]

template<class T = int>

T time_shield::us_of_sec ( fts_t ts )

constexprnoexcept

Get the microsecond part of the second from a floating-point timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in floating-point seconds.

Returns: T Microsecond part of the second.

Definition at line 41 of file time_conversions.hpp.

◆ week_begin() [1/2]

long time_shield::week_begin ( long ts )

Alias for start_of_week.

Get the timestamp of the beginning of the week.

This function finds the timestamp of the beginning of the week, which corresponds to the start of Sunday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the week.

Definition at line 985 of file time_conversions.mqh.

◆ week_begin() [2/2]

ts_t time_shield::week_begin ( ts_t ts = time_shield::ts() )

constexpr

Alias for start_of_week function.

Get the timestamp of the beginning of the week.

This function finds the timestamp of the beginning of the week, which corresponds to the start of Sunday.

Parameters

ts	Timestamp (default: current timestamp).

Returns: Returns the timestamp of the beginning of the week.

Definition at line 1943 of file time_conversion_aliases.hpp.

◆ weekday() [1/2]

template<class T1 = Weekday>

T1 time_shield::weekday	(	year_t	year,
		int	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1734 of file time_conversion_aliases.hpp.

◆ weekday() [2/2]

template<class T1 = Weekday>

T1 time_shield::weekday	(	year_t	year,
		Month	month,
		int	day )

constexpr

Alias for day_of_week_date.

Get the day of the week.

Template Parameters

T1	Return type (default: Weekday).
T2	Year type.
T3	Month type.
T4	Day type.

Parameters

year	Year.
month	Month.
day	Day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1741 of file time_conversion_aliases.hpp.

◆ weekday_of()

template<class T1 = Weekday, class T2, typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

T1 time_shield::weekday_of ( const T2 & date )

constexpr

Alias for get_weekday_from_date.

Get the day of the week from a date structure.

This function takes a date structure with fields 'year', 'mon', and 'day', and returns the day of the week (SUN = 0, MON = 1, ... SAT = 6).

Parameters

date	Structure containing year, month, and day.

Returns: Day of the week (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1781 of file time_conversion_aliases.hpp.

◆ weekday_of_ts()

template<class T = Weekday, class U, typename std::enable_if< std::is_integral< U >::value, int >::type = 0>

T time_shield::weekday_of_ts ( U ts )

constexprnoexcept

Alias for get_weekday_from_ts.

Get the weekday from a timestamp.

Parameters

ts	Timestamp.

Returns: Weekday (SUN = 0, MON = 1, ... SAT = 6).

Definition at line 1836 of file time_conversion_aliases.hpp.

◆ year() [1/2]

long time_shield::year ( long ts )

Alias for get_year.

Get the year from the timestamp.

This function returns the year of the specified timestamp in seconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 246 of file time_conversions.mqh.

◆ year() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::year ( ts_t ts = time_shield::ts() )

inline

Alias for get_year function.

Get the year from the timestamp.

This function returns the year of the specified timestamp in seconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts	Timestamp in seconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1472 of file time_conversion_aliases.hpp.

◆ year_begin() [1/2]

long time_shield::year_begin ( long ts )

Alias for start_of_year.

Get the start of the year timestamp.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts	Timestamp.

Returns: Start of the year timestamp.

Definition at line 660 of file time_conversions.mqh.

◆ year_begin() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_begin ( ts_t ts = time_shield::ts() )

inline

Alias for start_of_year function.

Get the start of the year timestamp.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts	Timestamp.

Returns: Start of the year timestamp.

Definition at line 1509 of file time_conversion_aliases.hpp.

◆ year_begin_date() [1/2]

long time_shield::year_begin_date ( long year )

Alias for start_of_year_date.

Get the timestamp of the start of the year.

This function returns the timestamp at the start of the specified year.

Parameters

year Year.

Returns: Timestamp of the start of the year.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 704 of file time_conversions.mqh.

◆ year_begin_date() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_begin_date ( T year )

inline

Alias for start_of_year_date function.

Get the timestamp of the start of the year.

This function returns the timestamp at the start of the specified year.

Parameters

year Year.

Returns: Timestamp of the start of the year.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1539 of file time_conversion_aliases.hpp.

◆ year_begin_date_ms() [1/2]

long time_shield::year_begin_date_ms ( long year )

Alias for start_of_year_date_ms.

Get the timestamp in milliseconds of the start of the year.

This function returns the timestamp at the start of the specified year in milliseconds.

Parameters

year Year.

Returns: Timestamp of the start of the year in milliseconds.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 719 of file time_conversions.mqh.

◆ year_begin_date_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::year_begin_date_ms ( T year )

inline

Alias for start_of_year_date_ms function.

Get the timestamp in milliseconds of the start of the year.

This function returns the timestamp at the start of the specified year in milliseconds.

Parameters

year Year.

Returns: Timestamp of the start of the year in milliseconds.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1555 of file time_conversion_aliases.hpp.

◆ year_begin_ms() [1/2]

long time_shield::year_begin_ms ( long ts_ms )

Alias for start_of_year_ms.

Get the start of the year timestamp in milliseconds.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of year timestamp in milliseconds.

Definition at line 675 of file time_conversions.mqh.

◆ year_begin_ms() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_begin_ms ( ts_t ts_ms = time_shield::ts_ms() )

inline

Alias for start_of_year_ms function.

Get the start of the year timestamp in milliseconds.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of year timestamp in milliseconds.

Definition at line 1523 of file time_conversion_aliases.hpp.

◆ year_end()

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_end ( ts_t ts = time_shield::ts() )

inline

Alias for end_of_year function.

Get the end-of-year timestamp.

This function finds the last timestamp of the current year.

Parameters

ts	Timestamp.

Returns: End-of-year timestamp.

Definition at line 1563 of file time_conversion_aliases.hpp.

◆ year_end_ms() [1/2]

long time_shield::year_end_ms ( long ts_ms )

Alias for end_of_year_ms.

Get the timestamp in milliseconds of the end of the year.

This function finds the last timestamp of the current year in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: End-of-year timestamp in milliseconds.

Definition at line 730 of file time_conversions.mqh.

◆ year_end_ms() [2/2]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::year_end_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Alias for end_of_year_ms function.

Get the timestamp in milliseconds of the end of the year.

This function finds the last timestamp of the current year in milliseconds.

Parameters

ts_ms Timestamp in milliseconds.

Returns: End-of-year timestamp in milliseconds.

Definition at line 1571 of file time_conversion_aliases.hpp.

◆ year_ms() [1/2]

long time_shield::year_ms ( long ts_ms )

Alias for get_year_ms.

Get the year from the timestamp in milliseconds.

This function returns the year of the specified timestamp in milliseconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts_ms Timestamp in milliseconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 261 of file time_conversions.mqh.

◆ year_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::year_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Alias for get_year_ms function.

Get the year from the timestamp in milliseconds.

This function returns the year of the specified timestamp in milliseconds since the Unix epoch.

Template Parameters

T	The return type of the function (default is year_t).

Parameters

ts_ms Timestamp in milliseconds (default is current timestamp).

Returns: Year of the specified timestamp.

Definition at line 1488 of file time_conversion_aliases.hpp.

◆ year_start() [1/2]

long time_shield::year_start ( long ts )

Alias for start_of_year.

Get the start of the year timestamp.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts	Timestamp.

Returns: Start of the year timestamp.

Definition at line 656 of file time_conversions.mqh.

◆ year_start() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_start ( ts_t ts = time_shield::ts() )

inline

Alias for start_of_year function.

Get the start of the year timestamp.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts	Timestamp.

Returns: Start of the year timestamp.

Definition at line 1503 of file time_conversion_aliases.hpp.

◆ year_start_date() [1/2]

long time_shield::year_start_date ( long year )

Alias for start_of_year_date.

Get the timestamp of the start of the year.

This function returns the timestamp at the start of the specified year.

Parameters

year Year.

Returns: Timestamp of the start of the year.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 700 of file time_conversions.mqh.

◆ year_start_date() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_start_date ( T year )

inline

Alias for start_of_year_date function.

Get the timestamp of the start of the year.

This function returns the timestamp at the start of the specified year.

Parameters

year Year.

Returns: Timestamp of the start of the year.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1532 of file time_conversion_aliases.hpp.

◆ year_start_date_ms() [1/2]

long time_shield::year_start_date_ms ( long year )

Alias for start_of_year_date_ms.

Get the timestamp in milliseconds of the start of the year.

This function returns the timestamp at the start of the specified year in milliseconds.

Parameters

year Year.

Returns: Timestamp of the start of the year in milliseconds.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 715 of file time_conversions.mqh.

◆ year_start_date_ms() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::year_start_date_ms ( T year )

inline

Alias for start_of_year_date_ms function.

Get the timestamp in milliseconds of the start of the year.

This function returns the timestamp at the start of the specified year in milliseconds.

Parameters

year Year.

Returns: Timestamp of the start of the year in milliseconds.

Exceptions

std::invalid_argument if the date-time combination is invalid.

Definition at line 1548 of file time_conversion_aliases.hpp.

◆ year_start_ms() [1/2]

long time_shield::year_start_ms ( long ts_ms )

Alias for start_of_year_ms.

Get the start of the year timestamp in milliseconds.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of year timestamp in milliseconds.

Definition at line 671 of file time_conversions.mqh.

◆ year_start_ms() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::year_start_ms ( ts_t ts_ms = time_shield::ts_ms() )

inline

Alias for start_of_year_ms function.

Get the start of the year timestamp in milliseconds.

This function resets the days, months, hours, minutes, and seconds of the given timestamp to the beginning of the year.

Parameters

ts_ms Timestamp in milliseconds.

Returns: Start of year timestamp in milliseconds.

Definition at line 1517 of file time_conversion_aliases.hpp.

Topics

Functions

Detailed Description

Key Features:

Usage Examples:

Function Documentation

◆ cet_to_gmt()

◆ day_end() [1/2]

◆ day_end() [2/2]

◆ day_end_ms() [1/2]

◆ day_end_ms() [2/2]

◆ day_end_sec() [1/2]

◆ day_end_sec() [2/2]

◆ day_of_month() [1/2]

◆ day_of_month() [2/2]

◆ day_of_week() [1/8]

◆ day_of_week() [2/8]

◆ day_of_week() [3/8]

◆ day_of_week() [4/8]

◆ day_of_week() [5/8]

◆ day_of_week() [6/8]

◆ day_of_week() [7/8]

◆ day_of_week() [8/8]

◆ day_of_week_date() [1/2]

◆ day_of_week_date() [2/2]

◆ day_of_week_dt() [1/3]

◆ day_of_week_dt() [2/3]

◆ day_of_week_dt() [3/3]

◆ day_of_week_ms() [1/2]

◆ day_of_week_ms() [2/2]

◆ day_of_year() [1/2]

◆ day_of_year() [2/2]

◆ day_start() [1/2]

◆ day_start() [2/2]

◆ day_start_ms() [1/2]

◆ day_start_ms() [2/2]

◆ day_start_sec() [1/2]

◆ day_start_sec() [2/2]

◆ days() [1/2]

◆ days() [2/2]

◆ days_in_month() [1/4]

◆ days_in_month() [2/4]

◆ days_in_month() [3/4]

◆ days_in_month() [4/4]

◆ days_in_year() [1/2]

◆ days_in_year() [2/2]

◆ days_in_year_ts() [1/2]

◆ days_in_year_ts() [2/2]

◆ dow() [1/3]

◆ dow() [2/3]

◆ dow() [3/3]

◆ dow_from_date()

◆ dow_ts()

◆ dt_to_ftimestamp() [1/3]

◆ dt_to_ftimestamp() [2/3]

◆ dt_to_ftimestamp() [3/3]

◆ dt_to_timestamp() [1/3]

◆ dt_to_timestamp() [2/3]

◆ dt_to_timestamp() [3/3]

◆ dt_to_timestamp_ms() [1/3]

◆ dt_to_timestamp_ms() [2/3]

◆ dt_to_timestamp_ms() [3/3]

◆ eet_to_gmt()

◆ end_of_day() [1/2]

◆ end_of_day() [2/2]

◆ end_of_day_from_unix_day() [1/2]

◆ end_of_day_from_unix_day() [2/2]

◆ end_of_day_from_unix_day_ms() [1/2]

◆ end_of_day_from_unix_day_ms() [2/2]

◆ end_of_day_ms() [1/2]

◆ end_of_day_ms() [2/2]

◆ end_of_day_sec() [1/2]

◆ end_of_day_sec() [2/2]

◆ end_of_hour() [1/2]

◆ end_of_hour() [2/2]

◆ end_of_hour_ms() [1/2]

◆ end_of_hour_ms() [2/2]

◆ end_of_hour_sec() [1/2]

◆ end_of_hour_sec() [2/2]

◆ end_of_min() [1/2]