Utility functions for working with timestamps and time components. More...

Classes
class	time_shield::CpuTickTimer
	Timer that measures CPU time ticks using get_cpu_time(). More...

Functions
struct timespec	time_shield::get_timespec_impl () noexcept
	Get the current timespec.
int64_t	time_shield::now_realtime_us ()
	Get current real time in microseconds using a platform-specific method.
ts_t	time_shield::monotonic_sec () noexcept
	Return monotonic seconds from a process-local reference.
ts_ms_t	time_shield::monotonic_ms () noexcept
	Return monotonic milliseconds from a process-local reference.
ts_us_t	time_shield::monotonic_us () noexcept
	Return monotonic microseconds from a process-local reference.
template<class T = int>
T	time_shield::ns_of_sec () noexcept
	Get the nanosecond part of the current second.
template<class T = int>
T	time_shield::us_of_sec () noexcept
	Get the microsecond part of the current second.
template<class T = int>
T	time_shield::ms_of_sec () noexcept
	Get the millisecond part of the current second.
ts_t	time_shield::timestamp () noexcept
	Get the current UTC timestamp in seconds.
fts_t	time_shield::fts () noexcept
	Get the current UTC timestamp in floating-point seconds.
fts_t	time_shield::ftimestamp () noexcept
	Get the current UTC timestamp in floating-point seconds.
ts_ms_t	time_shield::ts_ms () noexcept
	Get the current UTC timestamp in milliseconds.
ts_ms_t	time_shield::timestamp_ms () noexcept
	Get the current UTC timestamp in milliseconds.
ts_ms_t	time_shield::now () noexcept
	Get the current UTC timestamp in milliseconds.
ts_us_t	time_shield::ts_us () noexcept
	Get the current UTC timestamp in microseconds.
ts_us_t	time_shield::timestamp_us () noexcept
	Get the current UTC timestamp in microseconds.
double	time_shield::get_cpu_time () noexcept
	Get the CPU time used by the current process.
long	time_shield::microseconds ()
	Get the number of microseconds since the UNIX epoch.
long	time_shield::ns_of_sec ()
	Get the nanosecond part of the current second.
int	time_shield::us_of_sec ()
	Get the microsecond part of the current second.
int	time_shield::ms_of_sec ()
	Get the millisecond part of the current second.
ts_t	time_shield::ts () noexcept
	Get the current UTC timestamp in seconds.

Detailed Description

Utility functions for working with timestamps and time components.

A collection of utility functions for working with timestamps and time components.

This module provides functions for obtaining the current timestamps in various formats (e.g., seconds, milliseconds, microseconds, floating-point seconds) and extracting sub-second components such as nanoseconds, microseconds, and milliseconds.

Key Features:

Obtain current UTC timestamps in seconds, milliseconds, and microseconds.
Support for floating-point and integer timestamp formats.
Extract nanoseconds, microseconds, and milliseconds from the current second.

Usage Examples:

Get the current timestamp in seconds:
time_shield::ts_t current_time = time_shield::ts();

time_shield::ts_t
int64_t ts_t
Unix timestamp in seconds since 1970‑01‑01T00:00:00Z.
Definition types.hpp:49

time_shield::ts
ts_t ts() noexcept
Get the current UTC timestamp in seconds.
Definition time_utils.hpp:210
Get the millisecond part of the current second:
int ms = time_shield::ms_of_sec();

time_shield::ms_of_sec
T ms_of_sec() noexcept
Get the millisecond part of the current second.
Definition time_utils.hpp:203
Get the current timestamp in milliseconds:
time_shield::ts_ms_t current_time_ms = time_shield::ts_ms();

time_shield::ts_ms_t
int64_t ts_ms_t
Unix timestamp in milliseconds since epoch.
Definition types.hpp:50

time_shield::ts_ms
ts_ms_t ts_ms() noexcept
Get the current UTC timestamp in milliseconds.
Definition time_utils.hpp:242

Function Documentation

◆ ftimestamp()

double time_shield::ftimestamp ( )

inlinenoexcept

Get the current UTC timestamp in floating-point seconds.

Alias for fts().

Returns: fts_t Current UTC timestamp in floating-point seconds.

Get the current UTC timestamp in floating-point seconds.

Returns: fts_t Current UTC timestamp in floating-point seconds.; Current UTC timestamp in floating-point seconds.

Definition at line 234 of file time_utils.hpp.

◆ fts()

double time_shield::fts ( )

inlinenoexcept

Get the current UTC timestamp in floating-point seconds.

Returns: fts_t Current UTC timestamp in floating-point seconds.; Current UTC timestamp in floating-point seconds.

Definition at line 226 of file time_utils.hpp.

◆ get_cpu_time()

double time_shield::get_cpu_time ( )

inlinenoexcept

Get the CPU time used by the current process.

Returns: CPU time in seconds, or NaN if not available.

Note: This function attempts multiple fallback methods depending on platform capabilities.

See also: https://habr.com/ru/articles/282301/ — original implementation idea

Definition at line 284 of file time_utils.hpp.

◆ get_timespec_impl()

struct timespec time_shield::get_timespec_impl ( )

inlinenoexcept

Get the current timespec.

Returns: struct timespec The current timespec.

Definition at line 40 of file time_utils.hpp.

◆ microseconds()

long time_shield::microseconds ( )

Get the number of microseconds since the UNIX epoch.

Returns: Microseconds since 1 January 1970.

Definition at line 32 of file time_utils.mqh.

◆ monotonic_ms()

ts_ms_t time_shield::monotonic_ms ( )

inlinenoexcept

Return monotonic milliseconds from a process-local reference.

Uses std::chrono::steady_clock and returns an opaque monotonic value that is only suitable for measuring intervals and deadlines.

Returns: Monotonic milliseconds from a process-local reference.

Definition at line 161 of file time_utils.hpp.

◆ monotonic_sec()

ts_t time_shield::monotonic_sec ( )

inlinenoexcept

Return monotonic seconds from a process-local reference.

Uses std::chrono::steady_clock and returns an opaque monotonic value that is only suitable for measuring intervals and deadlines.

Returns: Monotonic seconds from a process-local reference.

Definition at line 149 of file time_utils.hpp.

◆ monotonic_us()

ts_us_t time_shield::monotonic_us ( )

inlinenoexcept

Return monotonic microseconds from a process-local reference.

Uses std::chrono::steady_clock and returns an opaque monotonic value that is only suitable for measuring intervals and deadlines.

Returns: Monotonic microseconds from a process-local reference.

Definition at line 173 of file time_utils.hpp.

◆ ms_of_sec() [1/2]

int time_shield::ms_of_sec ( )

Get the millisecond part of the current second.

Returns: Millisecond part of the current second.

Definition at line 63 of file time_utils.mqh.

◆ ms_of_sec() [2/2]

template<class T = int>

T time_shield::ms_of_sec ( )

inlinenoexcept

Get the millisecond part of the current second.

Template Parameters

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

Returns: T Millisecond part of the current second.

Definition at line 203 of file time_utils.hpp.

◆ now()

long time_shield::now ( )

inlinenoexcept

Get the current UTC timestamp in milliseconds.

Alias for ts_ms().

Returns: ts_ms_t Current UTC timestamp in milliseconds.

Get the current UTC timestamp in milliseconds.

Returns: ts_ms_t Current UTC timestamp in milliseconds.; Current UTC timestamp in milliseconds.

Definition at line 258 of file time_utils.hpp.

◆ now_realtime_us()

int64_t time_shield::now_realtime_us ( )

inline

Get current real time in microseconds using a platform-specific method.

On Windows this function combines QueryPerformanceCounter (high-resolution monotonic clock) with GetSystemTimeAsFileTime to compute an accurate, stable UTC timestamp. The base time is initialized only once per process (lazy init). On Unix-like systems a realtime anchor is captured once and combined with a high-resolution monotonic clock to compute stable timestamps.

Returns: Current UTC timestamp in microseconds.

Definition at line 61 of file time_utils.hpp.

◆ ns_of_sec() [1/2]

long time_shield::ns_of_sec ( )

Get the nanosecond part of the current second.

Returns: Nanosecond part of the current second.

Definition at line 51 of file time_utils.mqh.

◆ ns_of_sec() [2/2]

template<class T = int>

T time_shield::ns_of_sec ( )

inlinenoexcept

Get the nanosecond part of the current second.

Template Parameters

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

Returns: T Nanosecond part of the current second.

Definition at line 183 of file time_utils.hpp.

◆ timestamp()

long time_shield::timestamp ( )

inlinenoexcept

Get the current UTC timestamp in seconds.

Alias for ts().

Returns: ts_t Current UTC timestamp in seconds.

Get the current UTC timestamp in seconds.

Returns: ts_t Current UTC timestamp in seconds.; Current UTC timestamp in seconds.

Definition at line 218 of file time_utils.hpp.

◆ timestamp_ms()

long time_shield::timestamp_ms ( )

inlinenoexcept

Get the current UTC timestamp in milliseconds.

Alias for ts_ms().

Returns: ts_ms_t Current UTC timestamp in milliseconds.

Get the current UTC timestamp in milliseconds.

Returns: ts_ms_t Current UTC timestamp in milliseconds.; Current UTC timestamp in milliseconds.

Definition at line 250 of file time_utils.hpp.

◆ timestamp_us()

long time_shield::timestamp_us ( )

inlinenoexcept

Get the current UTC timestamp in microseconds.

Alias for ts_us().

Returns: ts_us_t Current UTC timestamp in microseconds.

Get the current UTC timestamp in microseconds.

Returns: ts_us_t Current UTC timestamp in microseconds.; Current UTC timestamp in microseconds.

Definition at line 274 of file time_utils.hpp.

◆ ts()

long time_shield::ts ( )

inlinenoexcept

Get the current UTC timestamp in seconds.

Returns: ts_t Current UTC timestamp in seconds.; Current UTC timestamp in seconds.

Definition at line 210 of file time_utils.hpp.

◆ ts_ms()

long time_shield::ts_ms ( )

inlinenoexcept

Get the current UTC timestamp in milliseconds.

Returns: ts_ms_t Current UTC timestamp in milliseconds.; Current UTC timestamp in milliseconds.

Definition at line 242 of file time_utils.hpp.

◆ ts_us()

long time_shield::ts_us ( )

inlinenoexcept

Get the current UTC timestamp in microseconds.

Returns: ts_us_t Current UTC timestamp in microseconds.; Current UTC timestamp in microseconds.

Definition at line 266 of file time_utils.hpp.

◆ us_of_sec() [1/2]

int time_shield::us_of_sec ( )

Get the microsecond part of the current second.

Returns: Microsecond part of the current second.

Definition at line 57 of file time_utils.mqh.

◆ us_of_sec() [2/2]

template<class T = int>

T time_shield::us_of_sec ( )

inlinenoexcept

Get the microsecond part of the current second.

Template Parameters

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

Returns: T Microsecond part of the current second.

Definition at line 193 of file time_utils.hpp.

Classes

Functions

Detailed Description

Key Features:

Usage Examples:

Function Documentation

◆ ftimestamp()

◆ fts()

◆ get_cpu_time()

◆ get_timespec_impl()

◆ microseconds()

◆ monotonic_ms()

◆ monotonic_sec()

◆ monotonic_us()

◆ ms_of_sec() [1/2]

◆ ms_of_sec() [2/2]

◆ now()

◆ now_realtime_us()

◆ ns_of_sec() [1/2]

◆ ns_of_sec() [2/2]

◆ timestamp()

◆ timestamp_ms()

◆ timestamp_us()

◆ ts()

◆ ts_ms()

◆ ts_us()

◆ us_of_sec() [1/2]

◆ us_of_sec() [2/2]