Time Conversions

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

Topics
	Time Zone Conversions
	Helpers for converting supported regional time zones and UTC.
	Time structure conversions

Files
file	astronomy_conversions.hpp
	Astronomy entry header with Julian conversions and lunar helpers.
file	julian_conversions.hpp
	Julian Date / MJD / JDN helpers using the proleptic Gregorian calendar.
file	MoonPhase.hpp
	Geocentric Moon phase calculator and result helpers.
file	ole_automation_conversions.hpp
	OLE Automation Date (OA date) conversions.

Namespaces
namespace	time_shield::legacy

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::first_workday_day (long year, int month)
int	time_shield::last_workday_day (long year, int month)
int	time_shield::count_workdays_in_month (long year, int month)
long	time_shield::start_of_first_workday_month (long year, int month)
	Get start timestamp of the first workday of a month.
long	time_shield::start_of_first_workday_month_ms (long year, int month)
	Get start timestamp in milliseconds of the first workday of a month.
long	time_shield::start_of_first_workday_month (long ts)
	Get start timestamp of the first workday of the month containing timestamp.
long	time_shield::start_of_first_workday_month_ms (long ts_ms)
	Get start timestamp in milliseconds of the first workday of the month containing timestamp.
long	time_shield::end_of_first_workday_month (long year, int month)
	Get end timestamp of the first workday of a month.
long	time_shield::end_of_first_workday_month_ms (long year, int month)
	Get end timestamp in milliseconds of the first workday of a month.
long	time_shield::end_of_first_workday_month (long ts)
	Get end timestamp of the first workday of the month containing timestamp.
long	time_shield::end_of_first_workday_month_ms (long ts_ms)
	Get end timestamp in milliseconds of the first workday of the month containing timestamp.
long	time_shield::start_of_last_workday_month (long year, int month)
	Get start timestamp of the last workday of a month.
long	time_shield::start_of_last_workday_month_ms (long year, int month)
	Get start timestamp in milliseconds of the last workday of a month.
long	time_shield::start_of_last_workday_month (long ts)
	Get start timestamp of the last workday of the month containing timestamp.
long	time_shield::start_of_last_workday_month_ms (long ts_ms)
	Get start timestamp in milliseconds of the last workday of the month containing timestamp.
long	time_shield::end_of_last_workday_month (long year, int month)
	Get end timestamp of the last workday of a month.
long	time_shield::end_of_last_workday_month_ms (long year, int month)
	Get end timestamp in milliseconds of the last workday of a month.
long	time_shield::end_of_last_workday_month (long ts)
	Get end timestamp of the last workday of the month containing timestamp.
long	time_shield::end_of_last_workday_month_ms (long ts_ms)
	Get end timestamp in milliseconds of the last workday of the month containing timestamp.
int	time_shield::workday_index_in_month (long year, int month, int day)
bool	time_shield::is_first_workday_of_month (long year, int month, int day)
bool	time_shield::is_within_first_workdays_of_month (long year, int month, int day, int count)
bool	time_shield::is_last_workday_of_month (long year, int month, int day)
bool	time_shield::is_within_last_workdays_of_month (long year, int month, int day, int count)
bool	time_shield::is_first_workday_of_month (const long ts)
bool	time_shield::is_within_first_workdays_of_month (const long ts, int count)
bool	time_shield::is_last_workday_of_month (const long ts)
bool	time_shield::is_within_last_workdays_of_month (const long ts, int count)
bool	time_shield::is_first_workday_of_month_ms (const long ts_ms)
bool	time_shield::is_within_first_workdays_of_month_ms (const long ts_ms, int count)
bool	time_shield::is_last_workday_of_month_ms (const long ts_ms)
bool	time_shield::is_within_last_workdays_of_month_ms (const long ts_ms, int count)
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::date_to_unix_day (const long year, const int month, const int day)
	Convert calendar date to UNIX day.
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.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::year_of (ts_t ts=time_shield::ts())
	Get the year from the timestamp.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::year_of_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Get the year from the timestamp in milliseconds.
template<class T1 = int, class T2 = year_t>
TIME_SHIELD_CONSTEXPR T1	time_shield::num_days_in_year (T2 year) noexcept
	Get the number of days in a year.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::num_days_in_year_ts (ts_t ts=time_shield::ts())
	Get the number of days in the current year.
template<class T1 = Weekday, class T2 = year_t, class T3 = int, class T4 = int>
TIME_SHIELD_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 >
TIME_SHIELD_CONSTEXPR T1	time_shield::weekday_of_date (const T2 &date)
	Get the day of the week from a date structure.
template<class T1 = Weekday, class T2 >
TIME_SHIELD_CONSTEXPR T1	time_shield::weekday_from_date (const T2 &date)
	Alias for weekday_of_date.
TIME_SHIELD_CONSTEXPR int	time_shield::iso_weekday_from_weekday (Weekday weekday) noexcept
	Convert Weekday enum to ISO weekday (Mon=1 .. Sun=7).
template<class Y = year_t, class M = Month, class D = int>
TIME_SHIELD_CONSTEXPR int	time_shield::iso_weekday_of_date (Y year, M month, D day)
	Get ISO weekday for a calendar date.
template<class Y = year_t, class M = Month, class D = int>
IsoWeekDateStruct	time_shield::to_iso_week_date (Y year, M month, D day)
	Convert calendar date to ISO week date.
IsoWeekDateStruct	time_shield::to_iso_week_date (const DateStruct &date)
	Convert DateStruct to ISO week date.
template<class T = ts_t>
IsoWeekDateStruct	time_shield::to_iso_week_date (T ts)
	Convert timestamp to ISO week date.
int	time_shield::iso_weeks_in_year (year_t iso_year)
	Calculate number of ISO weeks in a year.
bool	time_shield::is_valid_iso_week_date (year_t iso_year, int week, int weekday)
	Validate ISO week date components.
DateStruct	time_shield::iso_week_date_to_date (const IsoWeekDateStruct &iso_date)
	Convert ISO week date to calendar date.
std::string	time_shield::format_iso_week_date (const IsoWeekDateStruct &iso_date, bool extended=true, bool include_weekday=true)
	Format ISO week date to string.
bool	time_shield::parse_iso_week_date (const char *input, std::size_t length, IsoWeekDateStruct &iso_date) noexcept
	Parse ISO week date string buffer.
bool	time_shield::parse_iso_week_date (const std::string &input, IsoWeekDateStruct &iso_date) noexcept
	Parse ISO week date string.
bool	time_shield::try_parse_iso_week_date (const char *input, std::size_t length, IsoWeekDateStruct &iso_date) noexcept
	Alias for parse_iso_week_date.
bool	time_shield::try_parse_iso_week_date (const std::string &input, IsoWeekDateStruct &iso_date) noexcept
	Alias for parse_iso_week_date, std::string overload.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unix_year (ts_t ts) noexcept
	Legacy alias for years_since_epoch.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unix_day (ts_t ts=time_shield::ts()) noexcept
	Legacy alias for days_since_epoch.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unix_day_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Legacy alias for days_since_epoch_ms.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_day_to_timestamp (dse_t unix_day) noexcept
	Legacy alias for unix_day_to_ts.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_day_to_timestamp_ms (dse_t unix_day) noexcept
	Legacy alias for unix_day_to_ts_ms.
template<class T = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unix_min (ts_t ts=time_shield::ts())
	Legacy alias for min_since_epoch.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_year (ts_t ts=time_shield::ts())
	Legacy alias for year_of.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_year_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Legacy alias for year_of_ms.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::get_weekday_from_date (const T2 &date)
	Legacy alias for weekday_of_date.
template<class T = Weekday, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T	time_shield::get_weekday_from_ts (U ts) noexcept
	Legacy alias for weekday_of_ts.
template<class T = Weekday>
TIME_SHIELD_CONSTEXPR T	time_shield::get_weekday_from_ts_ms (ts_ms_t ts_ms)
	Legacy alias for weekday_of_ts_ms.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_unix_day (dse_t unix_day) noexcept
	Legacy alias for start_of_next_day_from_unix_day.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_unixday (dse_t unix_day) noexcept
	Legacy alias for start_of_next_day_from_unix_day.
template<class T = ts_ms_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_unix_day_ms (dse_t unix_day) noexcept
	Legacy alias for start_of_next_day_from_unix_day_ms.
template<class T = ts_ms_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_unixday_ms (dse_t unix_day) noexcept
	Legacy alias for start_of_next_day_from_unix_day_ms.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_year (ts_t ts) noexcept
	Alias for years_since_epoch function.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::to_unix_year (ts_t ts) noexcept
	Alias for years_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unixday (ts_t ts=time_shield::ts()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_day (ts_t ts=time_shield::ts()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::dse (ts_t ts=time_shield::ts()) noexcept
	Short alias for days_since_epoch.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unixday (ts_t ts=time_shield::ts()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::uday (ts_t ts=time_shield::ts()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::get_unixday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_day_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::dse_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Short alias for days_since_epoch_ms.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unixday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for days_since_epoch function.
template<class T = dse_t>
TIME_SHIELD_CONSTEXPR T	time_shield::uday_ms (ts_ms_t t_ms=time_shield::ts_ms()) noexcept
	Alias for days_since_epoch function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unixday_to_ts (dse_t unix_day) noexcept
	Alias for unix_day_to_ts function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::dse_to_ts (dse_t unix_day) noexcept
	Short alias for unix_day_to_ts.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::uday_to_ts (dse_t unix_day) noexcept
	Alias for unix_day_to_ts function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::start_of_day_from_unix_day (dse_t unix_day) noexcept
	Alias for unix_day_to_ts function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unixday_to_ts_ms (dse_t unix_day) noexcept
	Alias for unix_day_to_ts_ms function.
template<class T = ts_ms_t>
TIME_SHIELD_CONSTEXPR T	time_shield::dse_to_ts_ms (dse_t unix_day) noexcept
	Short alias for unix_day_to_ts_ms.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::uday_to_ts_ms (dse_t unix_day) noexcept
	Alias for unix_day_to_ts_ms function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::start_of_day_from_unix_day_ms (dse_t unix_day) noexcept
	Alias for unix_day_to_ts_ms function.
template<class T = ts_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_from_unix_day (dse_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day function.
template<class T = ts_ms_t>
TIME_SHIELD_CONSTEXPR T	time_shield::next_day_from_unix_day_ms (dse_t unix_day) noexcept
	Alias for start_of_next_day_from_unix_day_ms function.
template<class T = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::minutes_since_epoch (ts_t ts=time_shield::ts())
	Alias for min_since_epoch function.
template<class T = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::unix_min (ts_t ts=time_shield::ts())
	Alias for min_since_epoch function.
template<class T = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::to_unix_min (ts_t ts=time_shield::ts())
	Alias for min_since_epoch function.
template<class T = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::umin (ts_t ts=time_shield::ts())
	Alias for min_since_epoch function.
template<class T >
TIME_SHIELD_CONSTEXPR auto	time_shield::dt_to_ts (const T &date_time) -> decltype(dt_to_timestamp(date_time))
	Alias for dt_to_timestamp.
TIME_SHIELD_CONSTEXPR auto	time_shield::tm_to_ts (const std::tm *timeinfo) -> decltype(tm_to_timestamp(timeinfo))
	Alias for tm_to_timestamp.
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.
auto	time_shield::to_dt (ts_t ts) -> decltype(to_date_time(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.
auto	time_shield::to_dt_ms (ts_ms_t ts_ms) -> decltype(to_date_time_ms< DateTimeStruct >(ts_ms))
	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.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::get_timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_ts (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::ts_from_tm (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::to_timestamp (const std::tm *timeinfo)
	Alias for tm_to_timestamp.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::ts_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::get_ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::get_timestamp_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::timestamp_ms (year_t year, int month, int day, int hour, int min)
	Alias for to_timestamp_ms.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day)
	Alias for to_timestamp_ms.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::to_ts_ms (year_t year, int month, int day, int hour)
	Alias for to_timestamp_ms.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_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 auto	time_shield::dt_to_ts_ms (const T &date_time) -> decltype(dt_to_timestamp_ms(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 auto	time_shield::tm_to_ts_ms (const std::tm *timeinfo) -> decltype(tm_to_timestamp_ms(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>
TIME_SHIELD_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>
TIME_SHIELD_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>
TIME_SHIELD_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 >
TIME_SHIELD_CONSTEXPR fts_t	time_shield::to_ftimestamp (const T &date_time)
	Alias for dt_to_ftimestamp.
template<class T >
constexpr auto	time_shield::dt_to_fts (const T &date_time) -> decltype(dt_to_ftimestamp(date_time))
	Alias for dt_to_ftimestamp.
template<class T >
TIME_SHIELD_CONSTEXPR fts_t	time_shield::to_fts (const T &date_time)
	Alias for dt_to_ftimestamp.
template<class T >
TIME_SHIELD_CONSTEXPR fts_t	time_shield::fts (const T &date_time)
	Alias for dt_to_ftimestamp.
template<class T >
TIME_SHIELD_CONSTEXPR fts_t	time_shield::ftimestamp (const T &date_time)
	Alias for dt_to_ftimestamp.
TIME_SHIELD_CONSTEXPR fts_t	time_shield::to_ftimestamp (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.
TIME_SHIELD_CONSTEXPR auto	time_shield::tm_to_fts (const std::tm *timeinfo) -> decltype(tm_to_ftimestamp(timeinfo))
	Alias for tm_to_ftimestamp.
TIME_SHIELD_CONSTEXPR fts_t	time_shield::to_fts (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.
TIME_SHIELD_CONSTEXPR fts_t	time_shield::fts (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.
TIME_SHIELD_CONSTEXPR fts_t	time_shield::ftimestamp (const std::tm *timeinfo)
	Alias for tm_to_ftimestamp.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::get_days (ts_t start, ts_t stop) noexcept
	Alias for days_between function.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::days (ts_t start, ts_t stop) noexcept
	Alias for days_between function.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::get_days_difference (ts_t start, ts_t stop) noexcept
	Alias for days_between function.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::diff_in_days (ts_t start, ts_t stop) noexcept
	Alias for days_between function.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::year (ts_t ts=time_shield::ts())
	Alias for year_of function.
template<class T = year_t>
TIME_SHIELD_CONSTEXPR T	time_shield::to_year (ts_t ts=time_shield::ts())
	Alias for year_of 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 year_of_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 year_of_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.
ts_ms_t	time_shield::year_start_ms (ts_ms_t ts_ms=time_shield::ts_ms())
	Alias for start_of_year_ms function.
ts_ms_t	time_shield::year_begin_ms (ts_ms_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::days_in_month (T2 year, T3 month) noexcept
	Alias for num_days_in_month function.
template<class T1 = int>
TIME_SHIELD_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>
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::days_in_year (T2 year) noexcept
	Alias for num_days_in_year function.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::days_in_year_ts (ts_t ts=time_shield::ts())
	Alias for num_days_in_year_ts function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::day_start (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_day function.
template<class T = int>
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_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>
TIME_SHIELD_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>
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::day_end (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_day function.
TIME_SHIELD_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.
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::day_of_week (year_t year, int month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::day_of_week (year_t year, Month month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::get_weekday (year_t year, int month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::get_weekday (year_t year, Month month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::weekday (year_t year, int month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::weekday (year_t year, Month month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_CONSTEXPR T1	time_shield::dow (year_t year, int month, int day)
	Alias for day_of_week_date.
template<class T1 = Weekday>
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::get_dow (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::dow_from_date (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::weekday_of (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::day_of_week_dt (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::day_of_week (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::dow (const T2 &date)
	Alias for weekday_of_date.
template<class T1 = Weekday, class T2 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T1	time_shield::wd (const T2 &date)
	Alias for weekday_of_date.
template<class T = Weekday, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T	time_shield::day_of_week (U ts) noexcept
	Alias for weekday_of_ts.
template<class T = Weekday, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T	time_shield::dow_ts (U ts) noexcept
	Alias for weekday_of_ts.
template<class T = Weekday, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T	time_shield::get_dow_from_ts (U ts) noexcept
	Alias for weekday_of_ts.
template<class T = Weekday, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>
TIME_SHIELD_CONSTEXPR T	time_shield::wd_ts (U ts) noexcept
	Alias for weekday_of_ts.
template<class T = Weekday>
TIME_SHIELD_CONSTEXPR T	time_shield::day_of_week_ms (ts_ms_t ts_ms)
	Alias for weekday_of_ts_ms function.
template<class T = Weekday>
TIME_SHIELD_CONSTEXPR T	time_shield::wd_ms (ts_ms_t ts_ms)
	Alias for weekday_of_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.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::hour_begin (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_hour function.
TIME_SHIELD_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.
TIME_SHIELD_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.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::finish_of_hour (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_hour function.
TIME_SHIELD_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.
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T	time_shield::hour_in_day (ts_t ts=time_shield::ts()) noexcept
	Alias for hour_of_day function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::week_begin (ts_t ts=time_shield::ts())
	Alias for start_of_week function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::finish_of_week (ts_t ts=time_shield::ts())
	Alias for end_of_week function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::saturday_begin (ts_t ts=time_shield::ts())
	Alias for start_of_saturday function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::min_begin (ts_t ts=time_shield::ts()) noexcept
	Alias for start_of_min function.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::finish_of_min (ts_t ts=time_shield::ts()) noexcept
	Alias for end_of_min function.
TIME_SHIELD_CONSTEXPR bool	time_shield::workday (ts_t ts) noexcept
	Alias for is_workday(ts_t).
TIME_SHIELD_CONSTEXPR bool	time_shield::workday_ms (ts_ms_t ts_ms) noexcept
	Alias for is_workday(ts_ms_t).
TIME_SHIELD_CONSTEXPR bool	time_shield::workday (year_t year, int month, int day) noexcept
	Alias for is_workday(year_t, int, int).
template<class T >
TIME_SHIELD_CONSTEXPR tz_t	time_shield::tz_offset (const T &tz) noexcept
	Alias for to_tz_offset.
TIME_SHIELD_CONSTEXPR tz_t	time_shield::offset_hm (int hour, int min=0) noexcept
	Alias for tz_offset_hm.
TIME_SHIELD_CONSTEXPR bool	time_shield::valid_tz_offset (tz_t off) noexcept
	Alias for is_valid_tz_offset.
template<class T = int>
TIME_SHIELD_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>
TIME_SHIELD_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>
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T	time_shield::ns_of_sec_signed (fts_t ts) noexcept
	Get the nanosecond part of the second from a floating-point timestamp (truncating).
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::us_of_sec_signed (fts_t ts) noexcept
	Get the microsecond part of the second from a floating-point timestamp (truncating).
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::ms_of_sec_signed (fts_t ts) noexcept
	Get the millisecond part of the second from a floating-point timestamp (truncating).
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::ms_part (ts_ms_t ts) noexcept
	Get the millisecond part of the timestamp.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::ms_of_ts (ts_ms_t ts) noexcept
	Alias for ms_part.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::us_part (ts_us_t ts) noexcept
	Get the microsecond part of the timestamp.
template<class T = int>
TIME_SHIELD_CONSTEXPR T	time_shield::us_of_ts (ts_us_t ts) noexcept
	Alias for us_part.
template<class T = int, class T2 = int64_t>
TIME_SHIELD_CONSTEXPR T	time_shield::ns_part (T2 ts) noexcept
	Get the nanosecond part of the timestamp.
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::sec_to_ms_impl (T t, std::true_type) noexcept
	Helper function for converting seconds to milliseconds (floating-point version).
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::sec_to_ms_impl (T t, std::false_type) noexcept
	Helper function for converting seconds to milliseconds (integral version).
template<class T1 = ts_ms_t, class T2 >
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::ms_to_sec (T2 ts_ms) noexcept
	Converts a timestamp from milliseconds to seconds.
template<class T = ts_ms_t>
TIME_SHIELD_CONSTEXPR fts_t	time_shield::ms_to_fsec (T ts_ms) noexcept
	Converts a timestamp from milliseconds to floating-point seconds.
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::min_to_ms_impl (T t, std::true_type) noexcept
	Helper function for converting minutes to milliseconds (floating-point version).
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::min_to_ms_impl (T t, std::false_type) noexcept
	Helper function for converting minutes to milliseconds (integral version).
template<class T1 = ts_ms_t, class T2 >
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::ms_to_min (T2 ts) noexcept
	Converts a timestamp from milliseconds to minutes.
template<class T >
TIME_SHIELD_CONSTEXPR ts_t	time_shield::min_to_sec_impl (T t, std::true_type) noexcept
	Helper function for converting minutes to seconds (floating-point version).
template<class T >
TIME_SHIELD_CONSTEXPR ts_t	time_shield::min_to_sec_impl (T t, std::false_type) noexcept
	Helper function for converting minutes to seconds (integral version).
template<class T1 = ts_t, class T2 >
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::sec_to_min (T2 ts) noexcept
	Converts a timestamp from seconds to minutes.
template<class T = int>
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR double	time_shield::sec_to_fmin (T ts) noexcept
	Converts a timestamp from seconds to floating-point minutes.
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::hour_to_ms_impl (T t, std::true_type) noexcept
	Helper function for converting hours to milliseconds (floating-point version).
template<class T >
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::hour_to_ms_impl (T t, std::false_type) noexcept
	Helper function for converting hours to milliseconds (integral version).
template<class T1 = ts_ms_t, class T2 >
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::ms_to_hour (T2 ts) noexcept
	Converts a timestamp from milliseconds to hours.
template<class T >
TIME_SHIELD_CONSTEXPR ts_t	time_shield::hour_to_sec_impl (T t, std::true_type) noexcept
	Helper function for converting hours to seconds (floating-point version).
template<class T >
TIME_SHIELD_CONSTEXPR ts_t	time_shield::hour_to_sec_impl (T t, std::false_type) noexcept
	Helper function for converting hours to seconds (integral version).
template<class T1 = ts_t, class T2 >
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR T1	time_shield::sec_to_hour (T2 ts) noexcept
	Converts a timestamp from seconds to hours.
template<class T = int>
TIME_SHIELD_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>
TIME_SHIELD_CONSTEXPR double	time_shield::sec_to_fhour (T ts) noexcept
	Converts a timestamp from seconds to floating-point hours.
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 T = TimeZoneStruct>
T	time_shield::to_time_zone (tz_t offset)
	Converts an integer to a time zone structure.
template<class T >
TIME_SHIELD_CONSTEXPR tz_t	time_shield::to_tz_offset (const T &tz) noexcept
	Convert time zone struct to offset in seconds.
TIME_SHIELD_CONSTEXPR tz_t	time_shield::tz_offset_hm (int hour, int min=0) noexcept
	Build offset in seconds from hours/minutes.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_valid_tz_offset (tz_t off) noexcept
	Check if a numeric offset is within supported bounds.
TIME_SHIELD_CONSTEXPR int	time_shield::first_workday_day (year_t year, int month) noexcept
	Finds the first workday number within a month.
TIME_SHIELD_CONSTEXPR int	time_shield::last_workday_day (year_t year, int month) noexcept
	Finds the last workday number within a month.
TIME_SHIELD_CONSTEXPR int	time_shield::count_workdays_in_month (year_t year, int month) noexcept
	Counts workdays within a month.
TIME_SHIELD_CONSTEXPR int	time_shield::workday_index_in_month (year_t year, int month, int day) noexcept
	Returns workday position in month starting from 1.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_first_workday_of_month (year_t year, int month, int day) noexcept
	Checks whether date is the first workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_first_workdays_of_month (year_t year, int month, int day, int count) noexcept
	Checks if date falls within the first N workdays of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_last_workday_of_month (year_t year, int month, int day) noexcept
	Checks whether date is the last workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_last_workdays_of_month (year_t year, int month, int day, int count) noexcept
	Checks if date falls within the last N workdays of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_first_workday_of_month (ts_t ts) noexcept
	Checks whether timestamp is the first workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_first_workday_of_month_ms (ts_ms_t ts_ms) noexcept
	Checks whether millisecond timestamp is the first workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_first_workdays_of_month (ts_t ts, int count) noexcept
	Checks if timestamp falls within the first N workdays of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_first_workdays_of_month_ms (ts_ms_t ts_ms, int count) noexcept
	Checks if millisecond timestamp falls within the first N workdays of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_last_workday_of_month (ts_t ts) noexcept
	Checks whether timestamp is the last workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_last_workday_of_month_ms (ts_ms_t ts_ms) noexcept
	Checks whether millisecond timestamp is the last workday of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_last_workdays_of_month (ts_t ts, int count) noexcept
	Checks if timestamp falls within the last N workdays of the month.
TIME_SHIELD_CONSTEXPR bool	time_shield::is_within_last_workdays_of_month_ms (ts_ms_t ts_ms, int count) noexcept
	Checks if millisecond timestamp falls within the last N workdays of the month.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_first_workday_month (year_t year, int month) noexcept
	Returns start-of-day timestamp for the first workday of month.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_first_workday_month_ms (year_t year, int month) noexcept
	Returns start-of-day millisecond timestamp for the first workday of month.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_first_workday_month (ts_t ts=time_shield::ts()) noexcept
	Returns start-of-day timestamp for the first workday of month derived from timestamp.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_first_workday_month_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Returns start-of-day millisecond timestamp for the first workday of month derived from millisecond timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_first_workday_month (year_t year, int month) noexcept
	Returns end-of-day timestamp for the first workday of month.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::end_of_first_workday_month_ms (year_t year, int month) noexcept
	Returns end-of-day millisecond timestamp for the first workday of month.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_first_workday_month (ts_t ts=time_shield::ts()) noexcept
	Returns end-of-day timestamp for the first workday of month derived from timestamp.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::end_of_first_workday_month_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Returns end-of-day millisecond timestamp for the first workday of month derived from millisecond timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_last_workday_month (year_t year, int month) noexcept
	Returns start-of-day timestamp for the last workday of month.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_last_workday_month_ms (year_t year, int month) noexcept
	Returns start-of-day millisecond timestamp for the last workday of month.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::start_of_last_workday_month (ts_t ts=time_shield::ts()) noexcept
	Returns start-of-day timestamp for the last workday of month derived from timestamp.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::start_of_last_workday_month_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Returns start-of-day millisecond timestamp for the last workday of month derived from millisecond timestamp.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_last_workday_month (year_t year, int month) noexcept
	Returns end-of-day timestamp for the last workday of month.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::end_of_last_workday_month_ms (year_t year, int month) noexcept
	Returns end-of-day millisecond timestamp for the last workday of month.
TIME_SHIELD_CONSTEXPR ts_t	time_shield::end_of_last_workday_month (ts_t ts=time_shield::ts()) noexcept
	Returns end-of-day timestamp for the last workday of month derived from timestamp.
TIME_SHIELD_CONSTEXPR ts_ms_t	time_shield::end_of_last_workday_month_ms (ts_ms_t ts_ms=time_shield::ts_ms()) noexcept
	Returns end-of-day millisecond timestamp for the last workday of month derived from millisecond timestamp.

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);

• Convert a date-time structure to a timestamp:

  auto ts = time_shield::to_timestamp(2024, 11, 25, 14, 30, 0);

• Determine the start of the current year:

  auto year_start = time_shield::start_of_year(time_shield::ts());

Function Documentation

count_workdays_in_month() [1/2]

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

Definition at line 851 of file time_conversions.mqh.

count_workdays_in_month() [2/2]

TIME_SHIELD_CONSTEXPR int time_shield::count_workdays_in_month ( year_t year, int month )

inlinenoexcept

Counts workdays within a month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 54 of file workday_conversions.hpp.

date_to_unix_day()

long time_shield::date_to_unix_day	(	const long	year,
		const int	month,
		const int	day )

Convert calendar date to UNIX day.

Parameters

year	Year component.
month	Month component.
day	Day component.

Returns

Number of days since UNIX epoch.

Definition at line 1331 of file time_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]

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

inlinenoexcept

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 1773 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]

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

inlinenoexcept

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 1789 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]

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

inlinenoexcept

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 1781 of file time_conversion_aliases.hpp.

day_of_month()

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_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::day_of_week

(

const T2 &

date

)

Alias for weekday_of_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 1889 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.

Legacy alias for weekday_of_ts.

Get the second of the week day 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>

TIME_SHIELD_CONSTEXPR T time_shield::day_of_week ( U ts )

noexcept

Alias for weekday_of_ts.

Get the second of the week day from a timestamp.

Parameters

ts	Timestamp.

Returns

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

Definition at line 1915 of file time_conversion_aliases.hpp.

day_of_week() [7/8]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::day_of_week	(	year_t	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 1798 of file time_conversion_aliases.hpp.

day_of_week() [8/8]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::day_of_week	(	year_t	year,
		Month	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 1805 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>

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

inline

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 72 of file date_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::day_of_week_dt

(

const T2 &

date

)

Alias for weekday_of_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 1881 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.

Legacy alias for weekday_of_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>

TIME_SHIELD_CONSTEXPR T time_shield::day_of_week_ms

(

ts_ms_t

ts_ms

)

Alias for weekday_of_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 1947 of file time_conversion_aliases.hpp.

day_of_year()

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_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. 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]

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

inlinenoexcept

Alias for start_of_day function.

Get the start of the day timestamp.

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

Parameters

ts	Timestamp.

Returns

Start of the day timestamp.

Definition at line 1716 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. 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]

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

inlinenoexcept

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. 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 1747 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. 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]

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

inlinenoexcept

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. 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 1733 of file time_conversion_aliases.hpp.

days() [1/2]

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

Alias for get_days_difference.

Alias for days_between 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 1378 of file time_conversions.mqh.

days() [2/2]

template<class T = int>

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

noexcept

Alias for days_between 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 1541 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>

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

noexcept

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 1674 of file time_conversion_aliases.hpp.

days_in_month() [4/4]

template<class T1 = int>

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

noexcept

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 1690 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 year.

Parameters

year

Year.

Returns

Number of days in the given year.

Definition at line 1081 of file time_conversions.mqh.

days_in_year() [2/2]

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

TIME_SHIELD_CONSTEXPR T1 time_shield::days_in_year ( T2 year )

noexcept

Alias for num_days_in_year function.

Get the number of days in a year.

Parameters

year

Year.

Returns

Number of days in the given year.

Definition at line 1699 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 1093 of file time_conversions.mqh.

days_in_year_ts() [2/2]

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::days_in_year_ts

(

ts_t

ts = time_shield::ts()

)

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 1708 of file time_conversion_aliases.hpp.

diff_in_days()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::diff_in_days ( ts_t start, ts_t stop )

noexcept

Alias for days_between 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 1555 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>

TIME_SHIELD_CONSTEXPR T1 time_shield::dow

(

const T2 &

date

)

Alias for weekday_of_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 1897 of file time_conversion_aliases.hpp.

dow() [2/3]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::dow	(	year_t	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 1840 of file time_conversion_aliases.hpp.

dow() [3/3]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::dow	(	year_t	year,
		Month	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 1847 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>

TIME_SHIELD_CONSTEXPR T1 time_shield::dow_from_date

(

const T2 &

date

)

Alias for weekday_of_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 1865 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>

TIME_SHIELD_CONSTEXPR T time_shield::dow_ts ( U ts )

noexcept

Alias for weekday_of_ts.

Get the second of the week day from a timestamp.

Parameters

ts	Timestamp.

Returns

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

Definition at line 1922 of file time_conversion_aliases.hpp.

dse()

template<class T = dse_t>

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

noexcept

Short alias for days_since_epoch.

Parameters

ts	Timestamp in seconds.

Returns

Number of days since the Unix epoch.

Definition at line 59 of file time_conversion_aliases.hpp.

dse_ms()

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::dse_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

noexcept

Short alias for days_since_epoch_ms.

Parameters

t_ms	Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 106 of file time_conversion_aliases.hpp.

dse_to_ts()

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::dse_to_ts ( dse_t unix_day )

noexcept

Short alias for unix_day_to_ts.

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 140 of file time_conversion_aliases.hpp.

dse_to_ts_ms()

template<class T = ts_ms_t>

TIME_SHIELD_CONSTEXPR T time_shield::dse_to_ts_ms ( dse_t unix_day )

noexcept

Short alias for unix_day_to_ts_ms.

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_ms_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 170 of file time_conversion_aliases.hpp.

dt_to_ftimestamp() [1/2]

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/2]

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_fts()

template<class T >

auto time_shield::dt_to_fts ( const T & date_time ) -> decltype(dt_to_ftimestamp(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 1462 of file time_conversion_aliases.hpp.

dt_to_timestamp() [1/2]

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/2]

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_ms() [1/2]

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/2]

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_ts()

template<class T >

TIME_SHIELD_CONSTEXPR auto time_shield::dt_to_ts ( const T & date_time ) -> decltype(dt_to_timestamp(date_time))

inline

Alias for dt_to_timestamp.

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 242 of file time_conversion_aliases.hpp.

dt_to_ts_ms()

template<class T >

TIME_SHIELD_CONSTEXPR auto time_shield::dt_to_ts_ms ( const T & date_time ) -> decltype(dt_to_timestamp_ms(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 and 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 containing year, month, day, hour, minute, second, and millisecond fields.

Returns

Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument

if the date-time combination is invalid.

Definition at line 1305 of file time_conversion_aliases.hpp.

end_of_day()

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_from_unix_day()

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 1452 of file time_conversions.mqh.

end_of_day_from_unix_day_ms()

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 1459 of file time_conversions.mqh.

end_of_day_ms()

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_sec()

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_first_workday_month() [1/4]

long time_shield::end_of_first_workday_month

(

long

ts

)

Get end timestamp of the first workday of the month containing timestamp.

Parameters

ts	Timestamp in seconds.

Returns

Timestamp at 23:59:59 of the first workday or ERROR_TIMESTAMP.

Definition at line 918 of file time_conversions.mqh.

end_of_first_workday_month() [2/4]

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

Get end timestamp of the first workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 23:59:59 of the first workday or ERROR_TIMESTAMP.

Definition at line 899 of file time_conversions.mqh.

end_of_first_workday_month() [3/4]

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

inlinenoexcept

Returns end-of-day timestamp for the first workday of month derived from timestamp.

Parameters

ts	Timestamp in seconds.

Definition at line 256 of file workday_conversions.hpp.

end_of_first_workday_month() [4/4]

TIME_SHIELD_CONSTEXPR ts_t time_shield::end_of_first_workday_month ( year_t year, int month )

inlinenoexcept

Returns end-of-day timestamp for the first workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 232 of file workday_conversions.hpp.

end_of_first_workday_month_ms() [1/4]

long time_shield::end_of_first_workday_month_ms

(

long

ts_ms

)

Get end timestamp in milliseconds of the first workday of the month containing timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 23:59:59.999 of the first workday or ERROR_TIMESTAMP.

Definition at line 925 of file time_conversions.mqh.

end_of_first_workday_month_ms() [2/4]

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

Get end timestamp in milliseconds of the first workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 23:59:59.999 of the first workday or ERROR_TIMESTAMP.

Definition at line 909 of file time_conversions.mqh.

end_of_first_workday_month_ms() [3/4]

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

inlinenoexcept

Returns end-of-day millisecond timestamp for the first workday of month derived from millisecond timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 262 of file workday_conversions.hpp.

end_of_first_workday_month_ms() [4/4]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::end_of_first_workday_month_ms ( year_t year, int month )

inlinenoexcept

Returns end-of-day millisecond timestamp for the first workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 244 of file workday_conversions.hpp.

end_of_hour()

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 1178 of file time_conversions.mqh.

end_of_hour_ms()

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 1200 of file time_conversions.mqh.

end_of_hour_sec()

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 1189 of file time_conversions.mqh.

end_of_last_workday_month() [1/4]

long time_shield::end_of_last_workday_month

(

long

ts

)

Get end timestamp of the last workday of the month containing timestamp.

Parameters

ts	Timestamp in seconds.

Returns

Timestamp at 23:59:59 of the last workday or ERROR_TIMESTAMP.

Definition at line 986 of file time_conversions.mqh.

end_of_last_workday_month() [2/4]

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

Get end timestamp of the last workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 23:59:59 of the last workday or ERROR_TIMESTAMP.

Definition at line 967 of file time_conversions.mqh.

end_of_last_workday_month() [3/4]

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

inlinenoexcept

Returns end-of-day timestamp for the last workday of month derived from timestamp.

Parameters

ts	Timestamp in seconds.

Definition at line 328 of file workday_conversions.hpp.

end_of_last_workday_month() [4/4]

TIME_SHIELD_CONSTEXPR ts_t time_shield::end_of_last_workday_month ( year_t year, int month )

inlinenoexcept

Returns end-of-day timestamp for the last workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 304 of file workday_conversions.hpp.

end_of_last_workday_month_ms() [1/4]

long time_shield::end_of_last_workday_month_ms

(

long

ts_ms

)

Get end timestamp in milliseconds of the last workday of the month containing timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 23:59:59.999 of the last workday or ERROR_TIMESTAMP.

Definition at line 993 of file time_conversions.mqh.

end_of_last_workday_month_ms() [2/4]

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

Get end timestamp in milliseconds of the last workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 23:59:59.999 of the last workday or ERROR_TIMESTAMP.

Definition at line 977 of file time_conversions.mqh.

end_of_last_workday_month_ms() [3/4]

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

inlinenoexcept

Returns end-of-day millisecond timestamp for the last workday of month derived from millisecond timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 334 of file workday_conversions.hpp.

end_of_last_workday_month_ms() [4/4]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::end_of_last_workday_month_ms ( year_t year, int month )

inlinenoexcept

Returns end-of-day millisecond timestamp for the last workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 316 of file workday_conversions.hpp.

end_of_min()

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 1266 of file time_conversions.mqh.

end_of_month()

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 1109 of file time_conversions.mqh.

end_of_period()

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

Get the end of a period.

Parameters

p	Positive period length in seconds.
ts	Timestamp (default current).

Returns

Timestamp of the end of the period, or ERROR_TIMESTAMP for invalid period values.

Definition at line 1311 of file time_conversions.mqh.

end_of_week()

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 1233 of file time_conversions.mqh.

end_of_year()

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_ms()

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.

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 1465 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 1469 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 1140 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 1987 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 time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns

Timestamp of the last Sunday of the current month at 00:00:00

Definition at line 1127 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 time to 00:00:00.

Parameters

ts	Timestamp (default is current timestamp)

Returns

Timestamp of the last Sunday of the current month at 00:00:00

Definition at line 1978 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.

Parameters

ts	Timestamp (default: current timestamp).

Returns

Returns the timestamp of the end of the hour.

Definition at line 1184 of file time_conversions.mqh.

finish_of_hour() [2/2]

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

inlinenoexcept

Alias for end_of_hour function.

Get the timestamp at the end of the hour.

Parameters

ts	Timestamp (default: current timestamp).

Returns

Returns the timestamp of the end of the hour.

Definition at line 2019 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 in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds (default: current timestamp).

Returns

Returns the timestamp of the end of the hour in milliseconds.

Definition at line 1206 of file time_conversions.mqh.

finish_of_hour_ms() [2/2]

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

inlinenoexcept

Alias for end_of_hour_ms function.

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

Parameters

ts_ms

Timestamp in milliseconds (default: current timestamp).

Returns

Returns the timestamp of the end of the hour in milliseconds.

Definition at line 2035 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 in seconds.

Parameters

ts_ms

Timestamp in milliseconds (default: current timestamp).

Returns

Returns the timestamp of the end of the hour in seconds.

Definition at line 1195 of file time_conversions.mqh.

finish_of_hour_sec() [2/2]

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

inlinenoexcept

Alias for end_of_hour_sec function.

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

Parameters

ts_ms

Timestamp in milliseconds (default: current timestamp).

Returns

Returns the timestamp of the end of the hour in seconds.

Definition at line 2027 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 1272 of file time_conversions.mqh.

finish_of_min() [2/2]

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

inlinenoexcept

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 2084 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 1239 of file time_conversions.mqh.

finish_of_week() [2/2]

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

inline

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 2060 of file time_conversion_aliases.hpp.

first_workday_day() [1/2]

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

Definition at line 833 of file time_conversions.mqh.

first_workday_day() [2/2]

TIME_SHIELD_CONSTEXPR int time_shield::first_workday_day ( year_t year, int month )

inlinenoexcept

Finds the first workday number within a month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 22 of file workday_conversions.hpp.

format_iso_week_date()

std::string time_shield::format_iso_week_date ( const IsoWeekDateStruct & iso_date, bool extended = true, bool include_weekday = true )

inline

Format ISO week date to string.

Parameters

iso_date	ISO week date to format.
extended	When true, uses extended format with separators ("YYYY-Www-D").
include_weekday	When false, omits weekday ("YYYY-Www") and ignores the weekday field.

Returns

Formatted ISO week-date string.

Definition at line 131 of file iso_week_conversions.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 170 of file time_unit_conversions.hpp.

ftimestamp() [1/3]

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

inline

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 1525 of file time_conversion_aliases.hpp.

ftimestamp() [2/3]

template<class T >

TIME_SHIELD_CONSTEXPR fts_t time_shield::ftimestamp

(

const T &

date_time

)

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 1487 of file time_conversion_aliases.hpp.

ftimestamp() [3/3]

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

TIME_SHIELD_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.

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 1444 of file time_conversion_aliases.hpp.

fts() [1/3]

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

inline

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 1518 of file time_conversion_aliases.hpp.

fts() [2/3]

template<class T >

TIME_SHIELD_CONSTEXPR fts_t time_shield::fts

(

const T &

date_time

)

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 1479 of file time_conversion_aliases.hpp.

fts() [3/3]

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

TIME_SHIELD_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.

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 1420 of file time_conversion_aliases.hpp.

get_days() [1/2]

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

Alias for get_days_difference.

Alias for days_between 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 1374 of file time_conversions.mqh.

get_days() [2/2]

template<class T = int>

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

noexcept

Alias for days_between 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 1534 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 1368 of file time_conversions.mqh.

get_days_difference() [2/2]

template<class T = int>

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

noexcept

Alias for days_between 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 1548 of file time_conversion_aliases.hpp.

get_dow()

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

TIME_SHIELD_CONSTEXPR T1 time_shield::get_dow

(

const T2 &

date

)

Alias for weekday_of_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 1857 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>

TIME_SHIELD_CONSTEXPR T time_shield::get_dow_from_ts ( U ts )

noexcept

Alias for weekday_of_ts.

Get the second of the week day from a timestamp.

Parameters

ts	Timestamp.

Returns

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

Definition at line 1929 of file time_conversion_aliases.hpp.

get_timestamp() [1/5]

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

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 791 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 500 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 520 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 541 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 563 of file time_conversion_aliases.hpp.

get_timestamp_ms() [1/5]

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

inline

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 1018 of file time_conversion_aliases.hpp.

get_timestamp_ms() [2/5]

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

inline

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 1036 of file time_conversion_aliases.hpp.

get_timestamp_ms() [3/5]

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

inline

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 1055 of file time_conversion_aliases.hpp.

get_timestamp_ms() [4/5]

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

inline

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 1075 of file time_conversion_aliases.hpp.

get_timestamp_ms() [5/5]

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

inline

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 1096 of file time_conversion_aliases.hpp.

get_ts() [1/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::get_ts ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 779 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 418 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 438 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 459 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 481 of file time_conversion_aliases.hpp.

get_ts_ms() [1/5]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::get_ts_ms ( year_t year, int month, int day )

inline

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 923 of file time_conversion_aliases.hpp.

get_ts_ms() [2/5]

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

inline

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 941 of file time_conversion_aliases.hpp.

get_ts_ms() [3/5]

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

inline

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 960 of file time_conversion_aliases.hpp.

get_ts_ms() [4/5]

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

inline

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 980 of file time_conversion_aliases.hpp.

get_ts_ms() [5/5]

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

inline

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 1001 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 1344 of file time_conversions.mqh.

get_unix_day() [2/2]

template<class T = dse_t>

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

noexcept

Legacy alias for days_since_epoch.

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 34 of file legacy_aliases.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 1383 of file time_conversions.mqh.

get_unix_day_ms() [2/2]

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::get_unix_day_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

noexcept

Legacy alias for days_since_epoch_ms.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 42 of file legacy_aliases.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 1508 of file time_conversions.mqh.

get_unix_min() [2/2]

template<class T = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::get_unix_min

(

ts_t

ts = time_shield::ts()

)

Legacy alias for min_since_epoch.

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 63 of file legacy_aliases.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>

TIME_SHIELD_CONSTEXPR T time_shield::get_unix_year ( ts_t ts )

noexcept

Legacy alias for years_since_epoch.

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

Definition at line 27 of file legacy_aliases.hpp.

get_unixday() [1/2]

long time_shield::get_unixday

(

long

ts

)

Alias for get_unix_day.

Legacy alias for days_since_epoch.

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 1354 of file time_conversions.mqh.

get_unixday() [2/2]

template<class T = dse_t>

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

noexcept

Alias for days_since_epoch function.

Parameters

ts	Timestamp in seconds.

Returns

Number of days since the Unix epoch.

Definition at line 41 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 1393 of file time_conversions.mqh.

get_unixday_ms() [2/2]

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::get_unixday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

noexcept

Alias for days_since_epoch function.

Parameters

t_ms	Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 88 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>

TIME_SHIELD_CONSTEXPR T1 time_shield::get_weekday	(	year_t	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 1812 of file time_conversion_aliases.hpp.

get_weekday() [3/3]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::get_weekday	(	year_t	year,
		Month	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 1819 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 , typename std::enable_if< std::is_class< T2 >::value, int >::type = 0>

TIME_SHIELD_CONSTEXPR T1 time_shield::get_weekday_from_date

(

const T2 &

date

)

Legacy alias for weekday_of_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 85 of file legacy_aliases.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, class U , typename std::enable_if< std::is_integral< U >::value, int >::type = 0>

TIME_SHIELD_CONSTEXPR T time_shield::get_weekday_from_ts ( U ts )

noexcept

Legacy alias for weekday_of_ts.

Get the second of the week day from a timestamp.

Parameters

ts	Timestamp.

Returns

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

Definition at line 93 of file legacy_aliases.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>

TIME_SHIELD_CONSTEXPR T time_shield::get_weekday_from_ts_ms

(

ts_ms_t

ts_ms

)

Legacy alias for weekday_of_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 100 of file legacy_aliases.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()

)

Legacy alias for year_of.

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 70 of file legacy_aliases.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()

)

Legacy alias for year_of_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 77 of file legacy_aliases.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 260 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 466 of file time_unit_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 1151 of file time_conversions.mqh.

hour_begin() [2/2]

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

inlinenoexcept

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 1995 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 1173 of file time_conversions.mqh.

hour_begin_ms() [2/2]

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

inlinenoexcept

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 2011 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 1162 of file time_conversions.mqh.

hour_begin_sec() [2/2]

TIME_SHIELD_CONSTEXPR ts_t time_shield::hour_begin_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

inlinenoexcept

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 2003 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 hour of day. This function returns a value between 0 to 23.

Parameters

ts	Timestamp in seconds (default: current timestamp).

Returns

Hour of day.

Definition at line 1217 of file time_conversions.mqh.

hour_in_day() [2/2]

template<class T = int>

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

noexcept

Alias for hour_of_day function.

Get hour of day. This function returns a value between 0 to 23.

Parameters

ts	Timestamp in seconds (default: current timestamp).

Returns

Hour of day.

Definition at line 2044 of file time_conversion_aliases.hpp.

hour_of_day()

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 1211 of file time_conversions.mqh.

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>

TIME_SHIELD_CONSTEXPR fts_t time_shield::hour_to_fsec ( T hr )

noexcept

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 448 of file time_unit_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 >

TIME_SHIELD_CONSTEXPR T1 time_shield::hour_to_ms ( T2 ts )

noexcept

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 357 of file time_unit_conversions.hpp.

hour_to_ms_impl() [1/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::hour_to_ms_impl ( T t, std::false_type  )

noexcept

Helper function for converting hours to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 346 of file time_unit_conversions.hpp.

hour_to_ms_impl() [2/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::hour_to_ms_impl ( T t, std::true_type  )

noexcept

Helper function for converting hours to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 337 of file time_unit_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 >

TIME_SHIELD_CONSTEXPR T1 time_shield::hour_to_sec ( T2 ts )

noexcept

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 415 of file time_unit_conversions.hpp.

hour_to_sec_impl() [1/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_t time_shield::hour_to_sec_impl ( T t, std::false_type  )

noexcept

Helper function for converting hours to seconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.

Returns

ts_t Timestamp in seconds.

Definition at line 404 of file time_unit_conversions.hpp.

hour_to_sec_impl() [2/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_t time_shield::hour_to_sec_impl ( T t, std::true_type  )

noexcept

Helper function for converting hours to seconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in hours.

Returns

ts_t Timestamp in seconds.

Definition at line 395 of file time_unit_conversions.hpp.

is_first_workday_of_month() [1/4]

bool time_shield::is_first_workday_of_month

(

const long

ts

)

Definition at line 1039 of file time_conversions.mqh.

is_first_workday_of_month() [2/4]

bool time_shield::is_first_workday_of_month	(	long	year,
		int	month,
		int	day )

Definition at line 1015 of file time_conversions.mqh.

is_first_workday_of_month() [3/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_first_workday_of_month ( ts_t ts )

inlinenoexcept

Checks whether timestamp is the first workday of the month.

Parameters

ts	Timestamp in seconds.

Definition at line 144 of file workday_conversions.hpp.

is_first_workday_of_month() [4/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_first_workday_of_month ( year_t year, int month, int day )

inlinenoexcept

Checks whether date is the first workday of the month.

Parameters

year	Target year.
month	Target month (1-12).
day	Day of month (1-based).

Definition at line 96 of file workday_conversions.hpp.

is_first_workday_of_month_ms() [1/2]

bool time_shield::is_first_workday_of_month_ms

(

const long

ts_ms

)

Definition at line 1055 of file time_conversions.mqh.

is_first_workday_of_month_ms() [2/2]

TIME_SHIELD_CONSTEXPR bool time_shield::is_first_workday_of_month_ms ( ts_ms_t ts_ms )

inlinenoexcept

Checks whether millisecond timestamp is the first workday of the month.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 150 of file workday_conversions.hpp.

is_last_workday_of_month() [1/4]

bool time_shield::is_last_workday_of_month

(

const long

ts

)

Definition at line 1047 of file time_conversions.mqh.

is_last_workday_of_month() [2/4]

bool time_shield::is_last_workday_of_month	(	long	year,
		int	month,
		int	day )

Definition at line 1027 of file time_conversions.mqh.

is_last_workday_of_month() [3/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_last_workday_of_month ( ts_t ts )

inlinenoexcept

Checks whether timestamp is the last workday of the month.

Parameters

ts	Timestamp in seconds.

Definition at line 170 of file workday_conversions.hpp.

is_last_workday_of_month() [4/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_last_workday_of_month ( year_t year, int month, int day )

inlinenoexcept

Checks whether date is the last workday of the month.

Parameters

year	Target year.
month	Target month (1-12).
day	Day of month (1-based).

Definition at line 121 of file workday_conversions.hpp.

is_last_workday_of_month_ms() [1/2]

bool time_shield::is_last_workday_of_month_ms

(

const long

ts_ms

)

Definition at line 1063 of file time_conversions.mqh.

is_last_workday_of_month_ms() [2/2]

TIME_SHIELD_CONSTEXPR bool time_shield::is_last_workday_of_month_ms ( ts_ms_t ts_ms )

inlinenoexcept

Checks whether millisecond timestamp is the last workday of the month.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 176 of file workday_conversions.hpp.

is_valid_iso_week_date()

bool time_shield::is_valid_iso_week_date ( year_t iso_year, int week, int weekday )

inline

Validate ISO week date components.

Parameters

iso_year	ISO week-numbering year.
week	ISO week number.
weekday	ISO weekday (1-7).

Returns

True if components form a valid ISO week date.

Definition at line 98 of file iso_week_conversions.hpp.

is_valid_tz_offset()

TIME_SHIELD_CONSTEXPR bool time_shield::is_valid_tz_offset ( tz_t off )

inlinenoexcept

Check if a numeric offset is within supported bounds.

Conservative range: [-12:00, +14:00].

Definition at line 57 of file time_zone_offset_conversions.hpp.

is_within_first_workdays_of_month() [1/4]

bool time_shield::is_within_first_workdays_of_month	(	const long	ts,
		int	count )

Definition at line 1043 of file time_conversions.mqh.

is_within_first_workdays_of_month() [2/4]

bool time_shield::is_within_first_workdays_of_month	(	long	year,
		int	month,
		int	day,
		int	count )

Definition at line 1019 of file time_conversions.mqh.

is_within_first_workdays_of_month() [3/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_first_workdays_of_month ( ts_t ts, int count )

inlinenoexcept

Checks if timestamp falls within the first N workdays of the month.

Parameters

ts	Timestamp in seconds.
count	Number of leading workdays to include.

Definition at line 157 of file workday_conversions.hpp.

is_within_first_workdays_of_month() [4/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_first_workdays_of_month ( year_t year, int month, int day, int count )

inlinenoexcept

Checks if date falls within the first N workdays of the month.

Parameters

year	Target year.
month	Target month (1-12).
day	Day of month (1-based).
count	Number of leading workdays to include.

Definition at line 105 of file workday_conversions.hpp.

is_within_first_workdays_of_month_ms() [1/2]

bool time_shield::is_within_first_workdays_of_month_ms	(	const long	ts_ms,
		int	count )

Definition at line 1059 of file time_conversions.mqh.

is_within_first_workdays_of_month_ms() [2/2]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_first_workdays_of_month_ms ( ts_ms_t ts_ms, int count )

inlinenoexcept

Checks if millisecond timestamp falls within the first N workdays of the month.

Parameters

ts_ms	Timestamp in milliseconds.
count	Number of leading workdays to include.

Definition at line 164 of file workday_conversions.hpp.

is_within_last_workdays_of_month() [1/4]

bool time_shield::is_within_last_workdays_of_month	(	const long	ts,
		int	count )

Definition at line 1051 of file time_conversions.mqh.

is_within_last_workdays_of_month() [2/4]

bool time_shield::is_within_last_workdays_of_month	(	long	year,
		int	month,
		int	day,
		int	count )

Definition at line 1031 of file time_conversions.mqh.

is_within_last_workdays_of_month() [3/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_last_workdays_of_month ( ts_t ts, int count )

inlinenoexcept

Checks if timestamp falls within the last N workdays of the month.

Parameters

ts	Timestamp in seconds.
count	Number of trailing workdays to include.

Definition at line 183 of file workday_conversions.hpp.

is_within_last_workdays_of_month() [4/4]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_last_workdays_of_month ( year_t year, int month, int day, int count )

inlinenoexcept

Checks if date falls within the last N workdays of the month.

Parameters

year	Target year.
month	Target month (1-12).
day	Day of month (1-based).
count	Number of trailing workdays to include.

Definition at line 130 of file workday_conversions.hpp.

is_within_last_workdays_of_month_ms() [1/2]

bool time_shield::is_within_last_workdays_of_month_ms	(	const long	ts_ms,
		int	count )

Definition at line 1067 of file time_conversions.mqh.

is_within_last_workdays_of_month_ms() [2/2]

TIME_SHIELD_CONSTEXPR bool time_shield::is_within_last_workdays_of_month_ms ( ts_ms_t ts_ms, int count )

inlinenoexcept

Checks if millisecond timestamp falls within the last N workdays of the month.

Parameters

ts_ms	Timestamp in milliseconds.
count	Number of trailing workdays to include.

Definition at line 190 of file workday_conversions.hpp.

iso_week_date_to_date()

DateStruct time_shield::iso_week_date_to_date ( const IsoWeekDateStruct & iso_date )

inline

Convert ISO week date to calendar date.

Parameters

iso_date

ISO week date structure.

Returns

Calendar date corresponding to the ISO week date.

Exceptions

std::invalid_argument

if the ISO week date is invalid.

Definition at line 111 of file iso_week_conversions.hpp.

iso_weekday_from_weekday()

TIME_SHIELD_CONSTEXPR int time_shield::iso_weekday_from_weekday ( Weekday weekday )

inlinenoexcept

Convert Weekday enum to ISO weekday (Mon=1 .. Sun=7).

Parameters

weekday

Weekday enum value.

Returns

ISO weekday number.

Definition at line 32 of file iso_week_conversions.hpp.

iso_weekday_of_date()

template<class Y = year_t, class M = Month, class D = int>

TIME_SHIELD_CONSTEXPR int time_shield::iso_weekday_of_date ( Y year, M month, D day )

inline

Get ISO weekday for a calendar date.

Parameters

year	Year component.
month	Month component.
day	Day component.

Returns

ISO weekday number (1=Monday .. 7=Sunday).

Definition at line 42 of file iso_week_conversions.hpp.

iso_weeks_in_year()

int time_shield::iso_weeks_in_year ( year_t iso_year )

inline

Calculate number of ISO weeks in a year.

Parameters

iso_year

ISO week-numbering year.

Returns

52 or 53 depending on the ISO year length.

Definition at line 88 of file iso_week_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 1115 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 1970 of file time_conversion_aliases.hpp.

last_sunday_month_day()

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 1133 of file time_conversions.mqh.

last_sunday_of_month()

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 1120 of file time_conversions.mqh.

last_workday_day() [1/2]

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

Definition at line 842 of file time_conversions.mqh.

last_workday_day() [2/2]

TIME_SHIELD_CONSTEXPR int time_shield::last_workday_day ( year_t year, int month )

inlinenoexcept

Finds the last workday number within a month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 38 of file workday_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 1261 of file time_conversions.mqh.

min_begin() [2/2]

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

inlinenoexcept

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 2076 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 1290 of file time_conversions.mqh.

min_of_day()

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 1277 of file time_conversions.mqh.

min_of_hour()

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 1284 of file time_conversions.mqh.

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>

TIME_SHIELD_CONSTEXPR fts_t time_shield::min_to_fsec ( T min )

noexcept

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 314 of file time_unit_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 >

TIME_SHIELD_CONSTEXPR T1 time_shield::min_to_ms ( T2 ts )

noexcept

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 224 of file time_unit_conversions.hpp.

min_to_ms_impl() [1/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::min_to_ms_impl ( T t, std::false_type  )

noexcept

Helper function for converting minutes to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 213 of file time_unit_conversions.hpp.

min_to_ms_impl() [2/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::min_to_ms_impl ( T t, std::true_type  )

noexcept

Helper function for converting minutes to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 204 of file time_unit_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 >

TIME_SHIELD_CONSTEXPR T1 time_shield::min_to_sec ( T2 ts )

noexcept

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 281 of file time_unit_conversions.hpp.

min_to_sec_impl() [1/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_t time_shield::min_to_sec_impl ( T t, std::false_type  )

noexcept

Helper function for converting minutes to seconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.

Returns

ts_t Timestamp in seconds.

Definition at line 270 of file time_unit_conversions.hpp.

min_to_sec_impl() [2/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_t time_shield::min_to_sec_impl ( T t, std::true_type  )

noexcept

Helper function for converting minutes to seconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in minutes.

Returns

ts_t Timestamp in seconds.

Definition at line 261 of file time_unit_conversions.hpp.

minutes_since_epoch()

template<class T = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::minutes_since_epoch

(

ts_t

ts = time_shield::ts()

)

Alias for min_since_epoch 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.

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 1104 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 1962 of file time_conversion_aliases.hpp.

month_of_year()

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.

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>

TIME_SHIELD_CONSTEXPR T time_shield::ms_of_sec ( fts_t ts )

noexcept

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 45 of file time_unit_conversions.hpp.

ms_of_sec_signed()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::ms_of_sec_signed ( fts_t ts )

noexcept

Get the millisecond part of the second from a floating-point timestamp (truncating).

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, truncating toward zero.

Definition at line 75 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T time_shield::ms_of_ts ( ts_ms_t ts )

noexcept

Alias for ms_part.

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 94 of file time_unit_conversions.hpp.

ms_part()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::ms_part ( ts_ms_t ts )

noexcept

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 85 of file time_unit_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>

TIME_SHIELD_CONSTEXPR fts_t time_shield::ms_to_fsec ( T ts_ms )

noexcept

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 191 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::ms_to_hour ( T2 ts )

noexcept

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 379 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::ms_to_min ( T2 ts )

noexcept

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 246 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::ms_to_sec ( T2 ts_ms )

noexcept

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 180 of file time_unit_conversions.hpp.

next_day()

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_from_unix_day() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_from_unix_day ( dse_t unix_day )

noexcept

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 193 of file time_conversion_aliases.hpp.

next_day_from_unix_day() [2/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 1503 of file time_conversions.mqh.

next_day_from_unix_day_ms()

template<class T = ts_ms_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_from_unix_day_ms ( dse_t unix_day )

noexcept

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.

next_day_ms()

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_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>

TIME_SHIELD_CONSTEXPR ts_t time_shield::next_day_start ( ts_t ts, T days = 1 )

noexcept

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 1756 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>

TIME_SHIELD_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.

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 1765 of file time_conversion_aliases.hpp.

next_day_unix_day() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_unix_day ( dse_t unix_day )

noexcept

Legacy alias for start_of_next_day_from_unix_day.

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 107 of file legacy_aliases.hpp.

next_day_unix_day() [2/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 1487 of file time_conversions.mqh.

next_day_unix_day_ms() [1/2]

template<class T = ts_ms_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_unix_day_ms ( dse_t unix_day )

noexcept

Legacy alias for start_of_next_day_from_unix_day_ms.

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 121 of file legacy_aliases.hpp.

next_day_unix_day_ms() [2/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 1495 of file time_conversions.mqh.

next_day_unixday() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_unixday ( dse_t unix_day )

noexcept

Legacy alias for start_of_next_day_from_unix_day.

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 114 of file legacy_aliases.hpp.

next_day_unixday() [2/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 1491 of file time_conversions.mqh.

next_day_unixday_ms() [1/2]

template<class T = ts_ms_t>

TIME_SHIELD_CONSTEXPR T time_shield::next_day_unixday_ms ( dse_t unix_day )

noexcept

Legacy alias for start_of_next_day_from_unix_day_ms.

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 128 of file legacy_aliases.hpp.

next_day_unixday_ms() [2/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 1499 of file time_conversions.mqh.

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>

TIME_SHIELD_CONSTEXPR T time_shield::ns_of_sec ( fts_t ts )

noexcept

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 25 of file time_unit_conversions.hpp.

ns_of_sec_signed()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::ns_of_sec_signed ( fts_t ts )

noexcept

Get the nanosecond part of the second from a floating-point timestamp (truncating).

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, truncating toward zero.

Definition at line 55 of file time_unit_conversions.hpp.

ns_part()

template<class T = int, class T2 = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::ns_part ( T2 ts )

noexcept

Get the nanosecond part of the timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in nanoseconds.

Returns

T Nanosecond part of the timestamp.

Definition at line 121 of file time_unit_conversions.hpp.

num_days_in_month() [1/3]

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/3]

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/3]

template<class T1 = int>

TIME_SHIELD_CONSTEXPR T1 time_shield::num_days_in_month ( ts_t ts = time_shield::ts() )

noexcept

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 1683 of file time_conversion_aliases.hpp.

num_days_in_month_ts()

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_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 1074 of file time_conversions.mqh.

num_days_in_year() [2/2]

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

TIME_SHIELD_CONSTEXPR T1 time_shield::num_days_in_year ( T2 year )

inlinenoexcept

Get the number of days in a year.

Parameters

year

Year.

Returns

Number of days in the given year.

Definition at line 45 of file date_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 1086 of file time_conversions.mqh.

num_days_in_year_ts() [2/2]

template<class T = int>

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

inline

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 57 of file date_conversions.hpp.

offset_hm()

TIME_SHIELD_CONSTEXPR tz_t time_shield::offset_hm ( int hour, int min = 0 )

inlinenoexcept

Alias for tz_offset_hm.

Build offset in seconds from hours/minutes.

Parameters

hour	Signed hours (e.g. -3, +5).
min	Minutes (0..59).

Definition at line 2118 of file time_conversion_aliases.hpp.

parse_iso_week_date() [1/2]

bool time_shield::parse_iso_week_date ( const char * input, std::size_t length, IsoWeekDateStruct & iso_date )

inlinenoexcept

Parse ISO week date string buffer.

Parameters

input	Pointer to character buffer (may be not null-terminated).
length	Length of the buffer.
iso_date	Output ISO week date structure.

Returns

True if parsing succeeded and produced a valid ISO week date; otherwise false.

Accepted forms include canonical YYYY-Www-D and YYYYWwwD, compatible mixed separator variants YYYY-WwwD and YYYYWww-D, uppercase or lowercase W, and omitted weekday with Monday default.

Definition at line 160 of file iso_week_conversions.hpp.

parse_iso_week_date() [2/2]

bool time_shield::parse_iso_week_date ( const std::string & input, IsoWeekDateStruct & iso_date )

inlinenoexcept

Parse ISO week date string.

Parameters

input	Input string containing ISO week date.
iso_date	Output ISO week date structure.

Returns

True if parsing succeeded and produced a valid ISO week date; otherwise false.

Parser accepts canonical and compatible mixed separator variants, uppercase or lowercase W, and Monday default when weekday is omitted.

Definition at line 238 of file iso_week_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>

TIME_SHIELD_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.

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 1725 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 1250 of file time_conversions.mqh.

saturday_begin() [2/2]

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

inline

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 2068 of file time_conversion_aliases.hpp.

sec_of_day() [1/2]

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 1543 of file time_conversions.mqh.

sec_of_day() [2/2]

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 1527 of file time_conversions.mqh.

sec_of_day_ms()

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 1534 of file time_conversions.mqh.

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>

TIME_SHIELD_CONSTEXPR double time_shield::sec_to_fhour ( T ts )

noexcept

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 457 of file time_unit_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>

TIME_SHIELD_CONSTEXPR double time_shield::sec_to_fmin ( T ts )

noexcept

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 323 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::sec_to_hour ( T2 ts )

noexcept

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 437 of file time_unit_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>

TIME_SHIELD_CONSTEXPR T1 time_shield::sec_to_min ( T2 ts )

noexcept

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 303 of file time_unit_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 >

TIME_SHIELD_CONSTEXPR T1 time_shield::sec_to_ms ( T2 ts )

noexcept

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 151 of file time_unit_conversions.hpp.

sec_to_ms_impl() [1/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::sec_to_ms_impl ( T t, std::false_type  )

noexcept

Helper function for converting seconds to milliseconds (integral version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in seconds.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 140 of file time_unit_conversions.hpp.

sec_to_ms_impl() [2/2]

template<class T >

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::sec_to_ms_impl ( T t, std::true_type  )

noexcept

Helper function for converting seconds to milliseconds (floating-point version).

Template Parameters

T	Type of the input timestamp.

Parameters

t	Timestamp in seconds.

Returns

ts_ms_t Timestamp in milliseconds.

Definition at line 131 of file time_unit_conversions.hpp.

start_day_sec()

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_day_sec ( ts_ms_t ts_ms = time_shield::ts_ms() )

inlinenoexcept

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. 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 1739 of file time_conversion_aliases.hpp.

start_of_day()

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_from_unix_day() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::start_of_day_from_unix_day ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts 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 154 of file time_conversion_aliases.hpp.

start_of_day_from_unix_day() [2/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 1424 of file time_conversions.mqh.

start_of_day_from_unix_day_ms() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::start_of_day_from_unix_day_ms ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts_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_ms_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 184 of file time_conversion_aliases.hpp.

start_of_day_from_unix_day_ms() [2/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 1447 of file time_conversions.mqh.

start_of_day_ms()

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_sec()

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_first_workday_month() [1/4]

long time_shield::start_of_first_workday_month

(

long

ts

)

Get start timestamp of the first workday of the month containing timestamp.

Parameters

ts	Timestamp in seconds.

Returns

Timestamp at 00:00:00 of the first workday or ERROR_TIMESTAMP.

Definition at line 884 of file time_conversions.mqh.

start_of_first_workday_month() [2/4]

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

Get start timestamp of the first workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 00:00:00 of the first workday or ERROR_TIMESTAMP.

Definition at line 865 of file time_conversions.mqh.

start_of_first_workday_month() [3/4]

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

inlinenoexcept

Returns start-of-day timestamp for the first workday of month derived from timestamp.

Parameters

ts	Timestamp in seconds.

Definition at line 219 of file workday_conversions.hpp.

start_of_first_workday_month() [4/4]

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_of_first_workday_month ( year_t year, int month )

inlinenoexcept

Returns start-of-day timestamp for the first workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 197 of file workday_conversions.hpp.

start_of_first_workday_month_ms() [1/4]

long time_shield::start_of_first_workday_month_ms

(

long

ts_ms

)

Get start timestamp in milliseconds of the first workday of the month containing timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the first workday or ERROR_TIMESTAMP.

Definition at line 891 of file time_conversions.mqh.

start_of_first_workday_month_ms() [2/4]

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

Get start timestamp in milliseconds of the first workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 00:00:00.000 of the first workday or ERROR_TIMESTAMP.

Definition at line 875 of file time_conversions.mqh.

start_of_first_workday_month_ms() [3/4]

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

inlinenoexcept

Returns start-of-day millisecond timestamp for the first workday of month derived from millisecond timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 225 of file workday_conversions.hpp.

start_of_first_workday_month_ms() [4/4]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::start_of_first_workday_month_ms ( year_t year, int month )

inlinenoexcept

Returns start-of-day millisecond timestamp for the first workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 208 of file workday_conversions.hpp.

start_of_hour()

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 1145 of file time_conversions.mqh.

start_of_hour_ms()

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 1167 of file time_conversions.mqh.

start_of_hour_sec()

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 1156 of file time_conversions.mqh.

start_of_last_workday_month() [1/4]

long time_shield::start_of_last_workday_month

(

long

ts

)

Get start timestamp of the last workday of the month containing timestamp.

Parameters

ts	Timestamp in seconds.

Returns

Timestamp at 00:00:00 of the last workday or ERROR_TIMESTAMP.

Definition at line 952 of file time_conversions.mqh.

start_of_last_workday_month() [2/4]

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

Get start timestamp of the last workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 00:00:00 of the last workday or ERROR_TIMESTAMP.

Definition at line 933 of file time_conversions.mqh.

start_of_last_workday_month() [3/4]

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

inlinenoexcept

Returns start-of-day timestamp for the last workday of month derived from timestamp.

Parameters

ts	Timestamp in seconds.

Definition at line 291 of file workday_conversions.hpp.

start_of_last_workday_month() [4/4]

TIME_SHIELD_CONSTEXPR ts_t time_shield::start_of_last_workday_month ( year_t year, int month )

inlinenoexcept

Returns start-of-day timestamp for the last workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 269 of file workday_conversions.hpp.

start_of_last_workday_month_ms() [1/4]

long time_shield::start_of_last_workday_month_ms

(

long

ts_ms

)

Get start timestamp in milliseconds of the last workday of the month containing timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the last workday or ERROR_TIMESTAMP.

Definition at line 959 of file time_conversions.mqh.

start_of_last_workday_month_ms() [2/4]

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

Get start timestamp in milliseconds of the last workday of a month.

Parameters

year	Year value.
month	Month value.

Returns

Timestamp at 00:00:00.000 of the last workday or ERROR_TIMESTAMP.

Definition at line 943 of file time_conversions.mqh.

start_of_last_workday_month_ms() [3/4]

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

inlinenoexcept

Returns start-of-day millisecond timestamp for the last workday of month derived from millisecond timestamp.

Parameters

ts_ms

Timestamp in milliseconds.

Definition at line 297 of file workday_conversions.hpp.

start_of_last_workday_month_ms() [4/4]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::start_of_last_workday_month_ms ( year_t year, int month )

inlinenoexcept

Returns start-of-day millisecond timestamp for the last workday of month.

Parameters

year	Target year.
month	Target month (1-12).

Definition at line 280 of file workday_conversions.hpp.

start_of_min()

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 1255 of file time_conversions.mqh.

start_of_month()

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 1098 of file time_conversions.mqh.

start_of_next_day()

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_from_unix_day()

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 1474 of file time_conversions.mqh.

start_of_next_day_from_unix_day_ms()

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 1481 of file time_conversions.mqh.

start_of_next_day_ms()

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_period()

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

Get the start of a period.

Parameters

p	Positive period length in seconds.
ts	Timestamp (default current). Use time_utils.ts().

Returns

Timestamp of the start of the period, or ERROR_TIMESTAMP for invalid period values.

Definition at line 1296 of file time_conversions.mqh.

start_of_prev_day()

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_saturday()

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 1244 of file time_conversions.mqh.

start_of_week()

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 1222 of file time_conversions.mqh.

start_of_year()

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_date()

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_ms()

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_ms()

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.

timestamp() [1/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::timestamp ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 785 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 764 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 582 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 602 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 623 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 645 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 1369 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 and 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 containing year, month, day, hour, minute, second, and millisecond fields.

Returns

Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument

if the date-time combination is invalid.

Definition at line 1332 of file time_conversion_aliases.hpp.

timestamp_ms() [3/7]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::timestamp_ms ( year_t year, int month, int day )

inline

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 1113 of file time_conversion_aliases.hpp.

timestamp_ms() [4/7]

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

inline

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 1131 of file time_conversion_aliases.hpp.

timestamp_ms() [5/7]

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

inline

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 1150 of file time_conversion_aliases.hpp.

timestamp_ms() [6/7]

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

inline

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 1170 of file time_conversion_aliases.hpp.

timestamp_ms() [7/7]

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

inline

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 1191 of file time_conversion_aliases.hpp.

tm_to_fts()

TIME_SHIELD_CONSTEXPR auto time_shield::tm_to_fts ( const std::tm * timeinfo ) -> decltype(tm_to_ftimestamp(timeinfo))

inline

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 1503 of file time_conversion_aliases.hpp.

tm_to_ts()

TIME_SHIELD_CONSTEXPR auto time_shield::tm_to_ts ( const std::tm * timeinfo ) -> decltype(tm_to_timestamp(timeinfo))

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 250 of file time_conversion_aliases.hpp.

tm_to_ts_ms()

TIME_SHIELD_CONSTEXPR auto time_shield::tm_to_ts_ms ( const std::tm * timeinfo ) -> decltype(tm_to_timestamp_ms(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 1348 of file time_conversion_aliases.hpp.

to_date_time()

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_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()

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_dt() [1/3]

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

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/3]

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

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 270 of file time_conversion_aliases.hpp.

to_dt() [3/3]

auto time_shield::to_dt ( ts_t ts ) -> decltype(to_date_time(ts))

inline

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

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 285 of file time_conversion_aliases.hpp.

to_dt_ms() [1/3]

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/3]

template<class T >

T time_shield::to_dt_ms ( ts_ms_t ts )

inline

Alias for to_date_time_ms function.

Parameters

ts	Timestamp in milliseconds.

Returns

Date-time structure created from the timestamp.

Definition at line 297 of file time_conversion_aliases.hpp.

to_dt_ms() [3/3]

auto time_shield::to_dt_ms ( ts_ms_t ts_ms ) -> decltype(to_date_time_ms<DateTimeStruct>(ts_ms))

inline

Alias for to_date_time_ms function.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Date-time structure created from the timestamp.

Definition at line 314 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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

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 278 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.

Parameters

ts	Timestamp in milliseconds.

Returns

Date-time structure created from the timestamp.

Definition at line 306 of file time_conversion_aliases.hpp.

to_ftimestamp() [1/4]

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/4]

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/4]

TIME_SHIELD_CONSTEXPR fts_t time_shield::to_ftimestamp ( const std::tm * timeinfo )

inline

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 1496 of file time_conversion_aliases.hpp.

to_ftimestamp() [4/4]

template<class T >

TIME_SHIELD_CONSTEXPR fts_t time_shield::to_ftimestamp

(

const T &

date_time

)

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 1454 of file time_conversion_aliases.hpp.

to_fts() [1/3]

TIME_SHIELD_CONSTEXPR fts_t time_shield::to_fts ( const std::tm * timeinfo )

inline

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 1511 of file time_conversion_aliases.hpp.

to_fts() [2/3]

template<class T >

TIME_SHIELD_CONSTEXPR fts_t time_shield::to_fts

(

const T &

date_time

)

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 1471 of file time_conversion_aliases.hpp.

to_fts() [3/3]

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

TIME_SHIELD_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.

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 1396 of file time_conversion_aliases.hpp.

to_iso_week_date() [1/3]

IsoWeekDateStruct time_shield::to_iso_week_date ( const DateStruct & date )

inline

Convert DateStruct to ISO week date.

Parameters

date	DateStruct instance.

Returns

ISO week date representation.

Definition at line 71 of file iso_week_conversions.hpp.

to_iso_week_date() [2/3]

template<class T = ts_t>

IsoWeekDateStruct time_shield::to_iso_week_date ( T ts )

inline

Convert timestamp to ISO week date.

Template Parameters

T	Timestamp type.

Parameters

ts	Timestamp in seconds.

Returns

ISO week date representation.

Definition at line 80 of file iso_week_conversions.hpp.

to_iso_week_date() [3/3]

template<class Y = year_t, class M = Month, class D = int>

IsoWeekDateStruct time_shield::to_iso_week_date ( Y year, M month, D day )

inline

Convert calendar date to ISO week date.

Parameters

year	Year component.
month	Month component.
day	Day component.

Returns

ISO week date representation.

Definition at line 52 of file iso_week_conversions.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 1550 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 22 of file time_zone_offset_conversions.hpp.

to_timestamp() [1/5]

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/5]

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/5]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_timestamp ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 809 of file time_conversion_aliases.hpp.

to_timestamp() [4/5]

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 737 of file time_conversion_aliases.hpp.

to_timestamp() [5/5]

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_ms() [1/5]

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/5]

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/5]

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 1341 of file time_conversion_aliases.hpp.

to_timestamp_ms() [4/5]

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 and 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 containing year, month, day, hour, minute, second, and millisecond fields.

Returns

Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument

if the date-time combination is invalid.

Definition at line 1296 of file time_conversion_aliases.hpp.

to_timestamp_ms() [5/5]

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_ts() [1/7]

TIME_SHIELD_CONSTEXPR ts_t time_shield::to_ts ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 797 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 746 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 664 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 684 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 705 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 727 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 1355 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 and 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 containing year, month, day, hour, minute, second, and millisecond fields.

Returns

Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument

if the date-time combination is invalid.

Definition at line 1314 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]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::to_ts_ms ( year_t year, int month, int day )

inline

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 1208 of file time_conversion_aliases.hpp.

to_ts_ms() [5/8]

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

inline

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 1226 of file time_conversion_aliases.hpp.

to_ts_ms() [6/8]

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

inline

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 1245 of file time_conversion_aliases.hpp.

to_ts_ms() [7/8]

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

inline

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 1265 of file time_conversion_aliases.hpp.

to_ts_ms() [8/8]

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

inline

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 1286 of file time_conversion_aliases.hpp.

to_tz_offset()

template<class T >

TIME_SHIELD_CONSTEXPR tz_t time_shield::to_tz_offset ( const T & tz )

inlinenoexcept

Convert time zone struct to offset in seconds.

Expects fields: hour, min, is_positive.

Definition at line 38 of file time_zone_offset_conversions.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 1556 of file time_conversions.mqh.

to_unix_min() [1/2]

long time_shield::to_unix_min

(

long

ts

)

Alias for get_unix_min.

Legacy alias for min_since_epoch.

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 1518 of file time_conversions.mqh.

to_unix_min() [2/2]

template<class T = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::to_unix_min

(

ts_t

ts = time_shield::ts()

)

Alias for min_since_epoch 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.

to_unix_year() [1/2]

long time_shield::to_unix_year

(

long

ts

)

Alias for get_unix_year function.

Legacy alias for years_since_epoch.

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

Definition at line 235 of file time_conversions.mqh.

to_unix_year() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::to_unix_year ( ts_t ts )

noexcept

Alias for years_since_epoch 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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

Definition at line 30 of file time_conversion_aliases.hpp.

to_year() [1/2]

long time_shield::to_year

(

long

ts

)

Alias for get_year.

Legacy alias for year_of.

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 year_of 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 1571 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.

Legacy alias for year_of_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 year_of_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 1587 of file time_conversion_aliases.hpp.

try_parse_iso_week_date() [1/2]

bool time_shield::try_parse_iso_week_date ( const char * input, std::size_t length, IsoWeekDateStruct & iso_date )

inlinenoexcept

Alias for parse_iso_week_date.

Parameters

input	Pointer to character buffer (may be not null-terminated).
length	Length of the buffer.
iso_date	Output ISO week date structure.

Returns

True if parsing succeeded and produced a valid ISO week date; otherwise false.

Definition at line 247 of file iso_week_conversions.hpp.

try_parse_iso_week_date() [2/2]

bool time_shield::try_parse_iso_week_date ( const std::string & input, IsoWeekDateStruct & iso_date )

inlinenoexcept

Alias for parse_iso_week_date, std::string overload.

Parameters

input	Input string containing ISO week date.
iso_date	Output ISO week date structure.

Returns

True if parsing succeeded and produced a valid ISO week date; otherwise false.

Definition at line 255 of file iso_week_conversions.hpp.

ts() [1/6]

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 773 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 755 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 336 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 356 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 377 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 399 of file time_conversion_aliases.hpp.

ts_from_tm()

TIME_SHIELD_CONSTEXPR ts_t time_shield::ts_from_tm ( const std::tm * timeinfo )

inline

Alias for tm_to_timestamp.

Converts a std::tm structure to a timestamp.

This function converts a given 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.

Definition at line 803 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 1362 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 and 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 containing year, month, day, hour, minute, second, and millisecond fields.

Returns

Timestamp in milliseconds representing the given date and time.

Exceptions

std::invalid_argument

if the date-time combination is invalid.

Definition at line 1323 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]

TIME_SHIELD_CONSTEXPR ts_ms_t time_shield::ts_ms ( year_t year, int month, int day )

inline

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 828 of file time_conversion_aliases.hpp.

ts_ms() [5/8]

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

inline

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 846 of file time_conversion_aliases.hpp.

ts_ms() [6/8]

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

inline

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 865 of file time_conversion_aliases.hpp.

ts_ms() [7/8]

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

inline

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 885 of file time_conversion_aliases.hpp.

ts_ms() [8/8]

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

inline

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 906 of file time_conversion_aliases.hpp.

tz_offset()

template<class T >

TIME_SHIELD_CONSTEXPR tz_t time_shield::tz_offset ( const T & tz )

inlinenoexcept

Alias for to_tz_offset.

Convert time zone struct to offset in seconds.

Expects fields: hour, min, is_positive.

Definition at line 2112 of file time_conversion_aliases.hpp.

tz_offset_hm()

TIME_SHIELD_CONSTEXPR tz_t time_shield::tz_offset_hm ( int hour, int min = 0 )

inlinenoexcept

Build offset in seconds from hours/minutes.

Parameters

hour	Signed hours (e.g. -3, +5).
min	Minutes (0..59).

Definition at line 48 of file time_zone_offset_conversions.hpp.

uday() [1/2]

long time_shield::uday

(

long

ts

)

Alias for get_unix_day.

Legacy alias for days_since_epoch.

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 1362 of file time_conversions.mqh.

uday() [2/2]

template<class T = dse_t>

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

noexcept

Alias for days_since_epoch function.

Parameters

ts	Timestamp in seconds.

Returns

Number of days since the Unix epoch.

Definition at line 77 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 1401 of file time_conversions.mqh.

uday_ms() [2/2]

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::uday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

noexcept

Alias for days_since_epoch function.

Parameters

t_ms	Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 124 of file time_conversion_aliases.hpp.

uday_to_ts() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::uday_to_ts ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts 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 147 of file time_conversion_aliases.hpp.

uday_to_ts() [2/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 1420 of file time_conversions.mqh.

uday_to_ts_ms() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::uday_to_ts_ms ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts_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_ms_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 177 of file time_conversion_aliases.hpp.

uday_to_ts_ms() [2/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 1443 of file time_conversions.mqh.

umin() [1/2]

long time_shield::umin

(

long

ts

)

Alias for get_unix_min.

Legacy alias for min_since_epoch.

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 1522 of file time_conversions.mqh.

umin() [2/2]

template<class T = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::umin

(

ts_t

ts = time_shield::ts()

)

Alias for min_since_epoch 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 232 of file time_conversion_aliases.hpp.

unix_day() [1/2]

long time_shield::unix_day

(

long

ts

)

Alias for get_unix_day.

Legacy alias for days_since_epoch.

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 1350 of file time_conversions.mqh.

unix_day() [2/2]

template<class T = dse_t>

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

noexcept

Alias for days_since_epoch function.

Parameters

ts	Timestamp in seconds.

Returns

Number of days since the Unix epoch.

Definition at line 50 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 1389 of file time_conversions.mqh.

unix_day_ms() [2/2]

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::unix_day_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

noexcept

Alias for days_since_epoch function.

Parameters

t_ms	Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 97 of file time_conversion_aliases.hpp.

unix_day_to_timestamp() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::unix_day_to_timestamp ( dse_t unix_day )

noexcept

Legacy alias for unix_day_to_ts.

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 49 of file legacy_aliases.hpp.

unix_day_to_timestamp() [2/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 1406 of file time_conversions.mqh.

unix_day_to_timestamp_ms() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::unix_day_to_timestamp_ms ( dse_t unix_day )

noexcept

Legacy alias for unix_day_to_ts_ms.

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_ms_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 56 of file legacy_aliases.hpp.

unix_day_to_timestamp_ms() [2/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 1429 of file time_conversions.mqh.

unix_day_to_ts()

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 1412 of file time_conversions.mqh.

unix_day_to_ts_ms()

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 1435 of file time_conversions.mqh.

unix_min() [1/2]

long time_shield::unix_min

(

long

ts

)

Alias for get_unix_min.

Legacy alias for min_since_epoch.

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 1514 of file time_conversions.mqh.

unix_min() [2/2]

template<class T = int64_t>

TIME_SHIELD_CONSTEXPR T time_shield::unix_min

(

ts_t

ts = time_shield::ts()

)

Alias for min_since_epoch 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.

unix_year() [1/2]

long time_shield::unix_year

(

long

ts

)

Alias for get_unix_year function.

Legacy alias for years_since_epoch.

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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

Definition at line 231 of file time_conversions.mqh.

unix_year() [2/2]

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::unix_year ( ts_t ts )

noexcept

Alias for years_since_epoch 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.

Note

Inspired by the algorithm described in: https://www.benjoffe.com/fast-date-64 This implementation is written from scratch (no code copied).

Definition at line 23 of file time_conversion_aliases.hpp.

unixday() [1/2]

long time_shield::unixday

(

long

ts

)

Alias for get_unix_day.

Legacy alias for days_since_epoch.

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 1358 of file time_conversions.mqh.

unixday() [2/2]

template<class T = dse_t>

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

noexcept

Alias for days_since_epoch function.

Parameters

ts	Timestamp in seconds.

Returns

Number of days since the Unix epoch.

Definition at line 68 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 1397 of file time_conversions.mqh.

unixday_ms() [2/2]

template<class T = dse_t>

TIME_SHIELD_CONSTEXPR T time_shield::unixday_ms ( ts_ms_t t_ms = time_shield::ts_ms() )

noexcept

Alias for days_since_epoch function.

Parameters

t_ms	Timestamp in milliseconds.

Returns

Number of days since the Unix epoch.

Definition at line 115 of file time_conversion_aliases.hpp.

unixday_to_ts() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::unixday_to_ts ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts 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 133 of file time_conversion_aliases.hpp.

unixday_to_ts() [2/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 1416 of file time_conversions.mqh.

unixday_to_ts_ms() [1/2]

template<class T = ts_t>

TIME_SHIELD_CONSTEXPR T time_shield::unixday_to_ts_ms ( dse_t unix_day )

noexcept

Alias for unix_day_to_ts_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_ms_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 163 of file time_conversion_aliases.hpp.

unixday_to_ts_ms() [2/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 1439 of file time_conversions.mqh.

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>

TIME_SHIELD_CONSTEXPR T time_shield::us_of_sec ( fts_t ts )

noexcept

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 35 of file time_unit_conversions.hpp.

us_of_sec_signed()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::us_of_sec_signed ( fts_t ts )

noexcept

Get the microsecond part of the second from a floating-point timestamp (truncating).

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, truncating toward zero.

Definition at line 65 of file time_unit_conversions.hpp.

us_of_ts()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::us_of_ts ( ts_us_t ts )

noexcept

Alias for us_part.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in microseconds.

Returns

T Microsecond part of the timestamp.

Definition at line 112 of file time_unit_conversions.hpp.

us_part()

template<class T = int>

TIME_SHIELD_CONSTEXPR T time_shield::us_part ( ts_us_t ts )

noexcept

Get the microsecond part of the timestamp.

Template Parameters

T	Type of the returned value (default is int).

Parameters

ts	Timestamp in microseconds.

Returns

T Microsecond part of the timestamp.

Definition at line 103 of file time_unit_conversions.hpp.

valid_tz_offset()

TIME_SHIELD_CONSTEXPR bool time_shield::valid_tz_offset ( tz_t off )

inlinenoexcept

Alias for is_valid_tz_offset.

Check if a numeric offset is within supported bounds.

Conservative range: [-12:00, +14:00].

Definition at line 2124 of file time_conversion_aliases.hpp.

wd()

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

TIME_SHIELD_CONSTEXPR T1 time_shield::wd

(

const T2 &

date

)

Alias for weekday_of_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 1905 of file time_conversion_aliases.hpp.

wd_ms()

template<class T = Weekday>

TIME_SHIELD_CONSTEXPR T time_shield::wd_ms

(

ts_ms_t

ts_ms

)

Alias for weekday_of_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 1954 of file time_conversion_aliases.hpp.

wd_ts()

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

TIME_SHIELD_CONSTEXPR T time_shield::wd_ts ( U ts )

noexcept

Alias for weekday_of_ts.

Get the second of the week day from a timestamp.

Parameters

ts	Timestamp.

Returns

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

Definition at line 1938 of file time_conversion_aliases.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 1228 of file time_conversions.mqh.

week_begin() [2/2]

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

inline

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 2052 of file time_conversion_aliases.hpp.

weekday() [1/2]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::weekday	(	year_t	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 1826 of file time_conversion_aliases.hpp.

weekday() [2/2]

template<class T1 = Weekday>

TIME_SHIELD_CONSTEXPR T1 time_shield::weekday	(	year_t	year,
		Month	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 1833 of file time_conversion_aliases.hpp.

weekday_from_date()

template<class T1 = Weekday, class T2 >

TIME_SHIELD_CONSTEXPR T1 time_shield::weekday_from_date ( const T2 & date )

inline

Alias for weekday_of_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 101 of file date_conversions.hpp.

weekday_of()

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

TIME_SHIELD_CONSTEXPR T1 time_shield::weekday_of

(

const T2 &

date

)

Alias for weekday_of_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 1873 of file time_conversion_aliases.hpp.

weekday_of_date()

template<class T1 = Weekday, class T2 >

TIME_SHIELD_CONSTEXPR T1 time_shield::weekday_of_date ( const T2 & date )

inline

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 93 of file date_conversions.hpp.

workday() [1/2]

TIME_SHIELD_CONSTEXPR bool time_shield::workday ( ts_t ts )

inlinenoexcept

Alias for is_workday(ts_t).

Check if a given timestamp corresponds to a workday (Monday to Friday).

Parameters

ts	Timestamp to check.

Returns

true if the day is a workday, false otherwise.

Definition at line 2092 of file time_conversion_aliases.hpp.

workday() [2/2]

TIME_SHIELD_CONSTEXPR bool time_shield::workday ( year_t year, int month, int day )

inlinenoexcept

Alias for is_workday(year_t, int, int).

Check if a calendar date corresponds to a workday (Monday to Friday).

Parameters

year	Year component of the date.
month	Month component of the date.
day	Day component of the date.

Returns

true if the date is valid and a workday, false otherwise.

Definition at line 2105 of file time_conversion_aliases.hpp.

workday_index_in_month() [1/2]

int time_shield::workday_index_in_month	(	long	year,
		int	month,
		int	day )

Definition at line 997 of file time_conversions.mqh.

workday_index_in_month() [2/2]

TIME_SHIELD_CONSTEXPR int time_shield::workday_index_in_month ( year_t year, int month, int day )

inlinenoexcept

Returns workday position in month starting from 1.

Parameters

year	Target year.
month	Target month (1-12).
day	Day of month (1-based).

Definition at line 72 of file workday_conversions.hpp.

workday_ms()

TIME_SHIELD_CONSTEXPR bool time_shield::workday_ms ( ts_ms_t ts_ms )

inlinenoexcept

Alias for is_workday(ts_ms_t).

Parameters

ts_ms

Timestamp in milliseconds.

Returns

True when the timestamp falls on a workday.

Definition at line 2099 of file time_conversion_aliases.hpp.

year() [1/2]

long time_shield::year

(

long

ts

)

Alias for get_year.

Legacy alias for year_of.

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 year_of 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 1564 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 1601 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.

Parameters

year

Year.

Returns

Timestamp at 00:00:00 of the first day of the year.

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.

Parameters

year

Year.

Returns

Timestamp at 00:00:00 of the first day of the year.

Definition at line 1631 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 1647 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 timestamp at the start of the year in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the first day of the year.

Definition at line 675 of file time_conversions.mqh.

year_begin_ms() [2/2]

ts_ms_t time_shield::year_begin_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Alias for start_of_year_ms function.

Get the timestamp at the start of the year in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the first day of the year.

Definition at line 1615 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 1655 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 millisecond 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 millisecond of the current year in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

End-of-year timestamp in milliseconds.

Definition at line 1663 of file time_conversion_aliases.hpp.

year_ms() [1/2]

long time_shield::year_ms

(

long

ts_ms

)

Alias for get_year_ms.

Legacy alias for year_of_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 year_of_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 1580 of file time_conversion_aliases.hpp.

year_of()

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::year_of ( 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 25 of file date_conversions.hpp.

year_of_ms()

template<class T = year_t>

TIME_SHIELD_CONSTEXPR T time_shield::year_of_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 37 of file date_conversions.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 1595 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.

Parameters

year

Year.

Returns

Timestamp at 00:00:00 of the first day of the year.

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.

Parameters

year

Year.

Returns

Timestamp at 00:00:00 of the first day of the year.

Definition at line 1624 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 1640 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 timestamp at the start of the year in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the first day of the year.

Definition at line 671 of file time_conversions.mqh.

year_start_ms() [2/2]

ts_ms_t time_shield::year_start_ms ( ts_ms_t ts_ms = time_shield::ts_ms() )

inline

Alias for start_of_year_ms function.

Get the timestamp at the start of the year in milliseconds.

Parameters

ts_ms

Timestamp in milliseconds.

Returns

Timestamp at 00:00:00.000 of the first day of the year.

Definition at line 1609 of file time_conversion_aliases.hpp.