std::chrono::time_point

Определено в заголовке `<chrono>`
template< class Clock, class Duration = typename Clock::duration > class time_point;		(с C++11)

Шаблон класса std::chrono::time_point представляет точку во времени. Он реализован как хранящий значение типа Duration, указывающее временной интервал от начала эпохи Clock.

Clock должно удовлетворять требованиям для Clock или быть std::chrono::local_t(с C++20).

(до C++23)

Типы членов

Тип члена	Определение
`clock`	`Clock`, часы, на которых измеряется эта точка времени
`duration`	`Duration`, тип `std::chrono::duration`, используемый для измерения времени с момента эпохи
`rep`	`Rep`, арифметический тип, представляющий количество тиков длительности
`period`	`Period`, тип `std::ratio`, представляющий период тика длительности

Члены-функции

(конструктор)	создаёт новую точку времени (публичная функция-член)
time_since_epoch	возвращает точку времени как длительность с начала часов (публичная функция-член)
operator+=operator-=	изменяет точку времени на заданную длительность (публичная функция-член)
operator++operator++(int)operator--operator--(int) (C++20)	увеличивает или уменьшает длительность (публичная функция-член)
min [статическая]	возвращает точку времени, соответствующую наименьшей длительности (публичная статическая функция-член)
max [статическая]	возвращает точку времени, соответствующую наибольшей длительности (публичная статическая функция-член)

Внешние функции

operator+operator- (C++11)	выполняет операции сложения и вычитания, связанные с точкой времени (шаблон функции)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++11)(C++11)(удалено в C++20)(C++11)(C++11)(C++11)(C++11)(C++20)	сравнивает две точки времени (шаблон функции)
time_point_cast (C++11)	преобразует точку времени в другую точку времени на тех же часах с другой длительностью (шаблон функции)
floor(std::chrono::time_point) (C++17)	преобразует time_point в другую, округляя вниз (шаблон функции)
ceil(std::chrono::time_point) (C++17)	преобразует time_point в другую, округляя вверх (шаблон функции)
round(std::chrono::time_point) (C++17)	преобразует time_point в другую, округляя до ближайшего, привязывая к чётному (шаблон функции)

Вспомогательные классы

std::common_type<std::chrono::time_point> (C++11)	специализация свойства `std::common_type` (специализация шаблона класса)
std::hash<std::chrono::time_point> (C++26)	поддержка хеширования для `std::chrono::time_point` (специализация шаблона класса)

Пример

#include <algorithm>
#include <chrono>
#include <ctime>
#include <iomanip>
#include <iostream>
 
void slow_motion()
{
    static int a[]{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12};
    // Generate Γ(13) == 12! permutations:
    while (std::ranges::next_permutation(a).found) {}
}
 
int main()
{
    using namespace std::literals; // enables literal suffixes, e.g. 24h, 1ms, 1s.
 
    const std::chrono::time_point<std::chrono::system_clock> now =
        std::chrono::system_clock::now();
 
    const std::time_t t_c = std::chrono::system_clock::to_time_t(now - 24h);
    std::cout << "24 hours ago, the time was "
              << std::put_time(std::localtime(&t_c), "%F %T.\n") << std::flush;
 
    const std::chrono::time_point<std::chrono::steady_clock> start =
        std::chrono::steady_clock::now();
 
    std::cout << "Different clocks are not comparable: \n"
                 "  System time: " << now.time_since_epoch() << "\n"
                 "  Steady time: " << start.time_since_epoch() << '\n';
 
    slow_motion();
 
    const auto end = std::chrono::steady_clock::now();
    std::cout
        << "Slow calculations took "
        << std::chrono::duration_cast<std::chrono::microseconds>(end - start) << " ≈ "
        << (end - start) / 1ms << "ms ≈ " // almost equivalent form of the above, but
        << (end - start) / 1s << "s.\n";  // using milliseconds and seconds accordingly
}

Возможный вывод:

24 hours ago, the time was 2021-02-15 18:28:52.
Different clocks are not comparable:
  System time: 1666497022681282572ns
  Steady time: 413668317434475ns
Slow calculations took 2090448µs ≈ 2090ms ≈ 2s.

См. также

duration (C++11)	временной интервал (шаблон класса)
year_month_day (C++20)	представляет конкретный `year`, `month` и `day` (класс)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/time_point