qb::UtcTimePoint Class Reference

Represents a UTC time point with nanosecond precision. More...

#include <timestamp.h>

Inheritance diagram for qb::UtcTimePoint:

Collaboration diagram for qb::UtcTimePoint:

Public Member Functions
	UtcTimePoint ()
	Default constructor, initializes to current UTC time.
constexpr	TimePoint () noexcept=default
	Default constructor, initializes to epoch.
constexpr	TimePoint (rep nanoseconds) noexcept
	Constructs a time point with specified time since epoch.
template<typename Clock, typename ChronoDuration>
	TimePoint (const std::chrono::time_point< Clock, ChronoDuration > &time_point) noexcept
	Constructs a time point from std::chrono::time_point.
constexpr	TimePoint (const TimePoint &) noexcept=default
constexpr	TimePoint (TimePoint &&) noexcept=default
Public Member Functions inherited from qb::TimePoint
constexpr	TimePoint () noexcept=default
	Default constructor, initializes to epoch.
constexpr	TimePoint (rep nanoseconds) noexcept
	Constructs a time point with specified time since epoch.
template<typename Clock, typename ChronoDuration>
	TimePoint (const std::chrono::time_point< Clock, ChronoDuration > &time_point) noexcept
	Constructs a time point from std::chrono::time_point.
constexpr	TimePoint (const TimePoint &) noexcept=default
constexpr	TimePoint (TimePoint &&) noexcept=default
constexpr TimePoint &	operator= (const TimePoint &) noexcept=default
constexpr TimePoint &	operator= (TimePoint &&) noexcept=default
chrono_time_point	to_chrono () const noexcept
	Converts to std::chrono::time_point.
template<typename Clock, typename ChronoDuration = typename Clock::duration>
std::chrono::time_point< Clock, ChronoDuration >	to () const noexcept
	Converts to any std::chrono::time_point.
constexpr rep	days () const noexcept
	Gets the time in days since epoch.
constexpr double	days_float () const noexcept
	Gets the time in days since epoch with fractional precision.
constexpr rep	hours () const noexcept
	Gets the time in hours since epoch.
constexpr double	hours_float () const noexcept
	Gets the time in hours since epoch with fractional precision.
constexpr rep	minutes () const noexcept
	Gets the time in minutes since epoch.
constexpr double	minutes_float () const noexcept
	Gets the time in minutes since epoch with fractional precision.
constexpr rep	seconds () const noexcept
	Gets the time in seconds since epoch.
constexpr double	seconds_float () const noexcept
	Gets the time in seconds since epoch with fractional precision.
constexpr rep	milliseconds () const noexcept
	Gets the time in milliseconds since epoch.
constexpr double	milliseconds_float () const noexcept
	Gets the time in milliseconds since epoch with fractional precision.
constexpr rep	microseconds () const noexcept
	Gets the time in microseconds since epoch.
constexpr double	microseconds_float () const noexcept
	Gets the time in microseconds since epoch with fractional precision.
constexpr rep	nanoseconds () const noexcept
	Gets the time in nanoseconds since epoch.
constexpr double	nanoseconds_float () const noexcept
	Gets the time in nanoseconds since epoch with double precision.
Duration	time_since_epoch () const noexcept
	Gets the duration since epoch.
constexpr rep	count () const noexcept
	Gets the total time in nanoseconds since epoch.
std::string	format (std::string_view format) const
	Formats the time point as a string.
std::string	to_iso8601 () const
	Converts to ISO8601 string.
TimePoint &	operator+= (const Duration &duration) noexcept
	Adds a duration to this time point.
TimePoint &	operator-= (const Duration &duration) noexcept
	Subtracts a duration from this time point.

Static Public Member Functions
static UtcTimePoint	now () noexcept
	Gets current UTC time.
Static Public Member Functions inherited from qb::TimePoint
static constexpr TimePoint	epoch () noexcept
	Represents the epoch (1970-01-01 00:00:00 UTC)
static TimePoint	now () noexcept
	Gets current system time.
static constexpr TimePoint	from_days (int64_t days) noexcept
	Factory method to create a TimePoint from days since epoch.
static constexpr TimePoint	from_hours (int64_t hours) noexcept
	Factory method to create a TimePoint from hours since epoch.
static constexpr TimePoint	from_minutes (int64_t minutes) noexcept
	Factory method to create a TimePoint from minutes since epoch.
static constexpr TimePoint	from_seconds (int64_t seconds) noexcept
	Factory method to create a TimePoint from seconds since epoch.
static constexpr TimePoint	from_milliseconds (int64_t ms) noexcept
	Factory method to create a TimePoint from milliseconds since epoch.
static constexpr TimePoint	from_microseconds (int64_t us) noexcept
	Factory method to create a TimePoint from microseconds since epoch.
static constexpr TimePoint	from_nanoseconds (int64_t ns) noexcept
	Factory method to create a TimePoint from nanoseconds since epoch.
static std::optional< TimePoint >	from_iso8601 (std::string_view iso8601) noexcept
	Creates a TimePoint from ISO8601 string.
static std::optional< TimePoint >	parse (std::string_view time_string, std::string_view format) noexcept
	Factory method to parse a string into a TimePoint.
static uint64_t	read_tsc () noexcept
	Reads CPU timestamp counter.
static uint64_t	nano () noexcept
	Gets the current time in nanoseconds since epoch.

Additional Inherited Members
Public Types inherited from qb::TimePoint
using	rep = uint64_t
	Type used for nanosecond representation.
using	chrono_time_point
	Underlying std::chrono time point type.
Protected Attributes inherited from qb::TimePoint
rep	_time_since_epoch {0}
	Time in nanoseconds since epoch.

Detailed Description

Represents a UTC time point with nanosecond precision.

Extends TimePoint to specifically represent times in Coordinated Universal Time (UTC).

Member Function Documentation

now()

UtcTimePoint qb::UtcTimePoint::now ( )

inlinestaticnoexcept

Gets current UTC time.

Returns

UtcTimePoint representing current UTC time

TimePoint() [1/2]

qb::TimePoint::TimePoint ( rep nanoseconds )

inlineexplicitconstexprnoexcept

Constructs a time point with specified time since epoch.

Parameters

nanoseconds

Time in nanoseconds since epoch

TimePoint() [2/2]

template<typename Clock, typename ChronoDuration>

qb::TimePoint::TimePoint ( const std::chrono::time_point< Clock, ChronoDuration > & time_point )

inlineexplicitnoexcept

Constructs a time point from std::chrono::time_point.

Template Parameters

Clock	The clock type
Duration	The duration type

Parameters

time_point

A std::chrono time point