std::chrono::time_point

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Utilities library

Type support (basic types, RTTI, type traits)

Dynamic memory management

Error handling

Program utilities

Variadic functions

Date and time

Function objects

initializer_list (C++11)

bitset

hash (C++11)

Relational operators

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Pairs and tuples

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward and move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Date and time utilities

time_point (C++11)

duration (C++11)

system_clock (C++11)

steady_clock (C++11)

high_resolution_clock (C++11)

C-style date and time

 

std::chrono::time_point

Member functions

time_point::time_point

time_point::time_since_epoch

time_point::operator+ time_point::operator-

time_point::min

time_point::max

Non-member functions

common_type

operator+ operator-

operator== operator!= operator< operator<= operator> operator>=

time_point_cast

 

Defined in header <chrono>
template<     class Clock,     class Duration = typename Clock::duration > class time_point;		(since C++11)

Class template std::chrono::time_point represents a point in time. It is implemented as if it stores a value of type Duration indicating the time interval from the start of the Clock's epoch.

Member types

Member type	Definition
clock	Clock, the clock on which this time point is measured
duration	Duration, a std::chrono::duration type used to measure the time since epoch
rep	Rep, an arithmetic type representing the number of ticks of the duration
period	Period, a std::ratio type representing the tick period of the duration

Member functions

(constructor)	constructs a new time point (public member function)
time_since_epoch	returns the time point as duration since the start of its clock (public member function)
operator+ operator-	modifies the time point by the given duration (public member function)
min [static]	returns the time point corresponding to the smallest duration (public static member function)
max [static]	returns the time point corresponding to the largest duration (public static member function)

Non-member functions

std::common_type<std::chrono::time_point>	specializes the std::common_type trait (class template specialization)
operator+ operator-	modifies the time point by the given duration (function template)
operator== operator!= operator< operator<= operator> operator>=	compares two time points (function template)
time_point_cast	converts a time point to another time point on the same clock, with a different duration (function template)

Example

This example prints the current time minus 24 hours:

run this code

#include <iostream>
#include <iomanip>
#include <ctime>
#include <chrono>
 
using std::chrono::system_clock;
 
int main()
{
    system_clock::time_point now = system_clock::now();
    std::time_t now_c = system_clock::to_time_t(
                            now - std::chrono::hours(24));
    std::cout << "One day ago, the time was "
              << std::put_time(std::localtime(&now_c), "%F %T") << '\n';
}

Possible output:

One day ago, the time was 2011-10-25 12:00:08

This example prints the time it takes to print "Hello World":

run this code

#include <iostream>
#include <chrono>
 
using std::chrono::duration_cast;
using std::chrono::microseconds;
using std::chrono::steady_clock;
 
int main()
{
    steady_clock::time_point start = steady_clock::now();
    std::cout << "Hello World\n";
    steady_clock::time_point end = steady_clock::now();
    std::cout << "Printing took "
              // duration_cast is required to avoid accidentally losing precision.
              << duration_cast<microseconds>(end - start).count()
              << "us.\n";
}

Possible output:

Hello World
Printing took 84us.

See also

duration (C++11)	a time interval (class template)