time_point class
A time_point represents a point in time that is relative to the epoch of a clock.
Syntax
template <class Clock, class Duration = typename Clock::duration>
class time_point;
Remarks
The clock that supplies the reference point for the epoch is specified by the template argument Clock.
Members
Convenience type aliases
| Name | Description |
|---|---|
clock |
Synonym for the template parameter Clock. |
duration |
Synonym for the template parameter Duration. |
period |
Synonym for the nested type name duration::period. |
rep |
Synonym for the nested type name duration::rep. |
Public constructors
| Name | Description |
|---|---|
time_point |
Constructs a time_point object. |
Public methods
| Name | Description |
|---|---|
max |
Specifies the upper limit for rep. |
min |
Specifies the lower limit for rep. |
time_since_epoch |
Returns the amount of time between this time_point and the clock's epoch (or time and date that the clock starts measuring time). |
Public operators
| Name | Description |
|---|---|
operator+= |
Adds a specified value to the stored duration. |
operator-= |
Subtracts a specified value from the stored duration. |
Requirements
Header: <chrono>
Namespace: std::chrono
max
Static method that returns the upper bound for values of type rep.
static constexpr time_point max();
Return value
In effect, returns time_point(duration::max()).
min
Static method that returns the lower bound for values of type rep.
static constexpr time_point min();
Return value
In effect, returns time_point(duration::min()).
operator+=
Adds a specified value to the stored duration value.
time_point& operator+=(const duration& Dur);
Parameters
Dur
A duration object.
Return value
The time_point object after the addition is done.
operator-=
Subtracts a specified value from the stored duration value.
time_point& operator-=(const duration& Dur);
Parameters
Dur
A duration object.
Return value
The time_point object after the subtraction is done.
time_point constructor
Constructs a time_point object.
constexpr time_point();
constexpr explicit time_point(const duration& Dur);
template <class Duration2>
constexpr time_point(const time_point<clock, Duration2>& Tp);
Parameters
Dur
A duration object.
Tp
A time_point object.
Remarks
The first constructor constructs an object whose stored duration value is equal to duration::zero.
The second constructor constructs an object whose stored duration value is equal to Dur. Unless is_convertible<Duration2, duration> holds true, the second constructor doesn't participate in overload resolution. For more information, see <type_traits>.
The third constructor initializes its duration value by using Tp.time_since_epoch().
time_since_epoch
Returns the amount of time between this time_point and the clock's epoch. (A clock's epoch is the time from which the clock starts measuring time, such as midnight 1/1/1970). It's returned as a duration value.
constexpr duration time_since_epoch() const;