std::chrono::time_point

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Функции работы с датой и временем

Момент времени
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
Длительность
duration (C++11)
Часы
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11)	is_clock (C++20) utc_clock (C++20) tai_clock (C++20)	gps_clock (C++20) file_clock (C++20) local_t (C++20)
Время суток
is_amis_pm (C++20)(C++20)	make12make24 (C++20)(C++20)	hh_mm_ss (C++20)
Календари
day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20)	year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)       weekday_indexed (C++20) weekday_last (C++20) month_day (C++20)	month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20)
Часовые пояса
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20)	local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20)	zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20)
Ввод/Вывод chrono
parse (C++20)
Дата и время в стиле C

 

std::chrono::time_point

Функции-элементы

time_point::time_point

time_point::time_since_epoch

time_point::operator+=time_point::operator-=

time_point::operator++time_point::operator-- (C++20)(C++20)

time_point::min

time_point::max

Функции, не являющиеся элементами

operator+operator-

operator==operator!=operator<operator<=operator>operator>=operator<=> (до C++20)(C++20)

time_point_cast

floor (C++17)

ceil (C++17)

round (C++17)

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

common_type

hash<std::chrono::time_point> (C++26)

 

<tbody> </tbody>

Определено в заголовочном файле <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, представляющий период длительности в тиках

Функции-элементы

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

Функции, не являющиеся элементами

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};
    // Генерирует Γ(13) == 12! перестановок:
    while (std::ranges::next_permutation(a).found) { }
}

int main()
{
    using namespace std::literals; // позволяет буквальные суффиксы, например
                                   // 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 часа назад время было "
              << 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 << "Разные часы несопоставимы: \n"
              << " Системное время: " << now.time_since_epoch() << "\n"
              << " Стабильное время: " << start.time_since_epoch() << "\n";

    slow_motion();

    const auto end = std::chrono::steady_clock::now();
    std::cout
      << "Медленные расчёты заняли "
      << std::chrono::duration_cast<std::chrono::microseconds>(end - start).count()
      << "мкс ≈ "
      << (end - start) / 1ms << "мс ≈ " // почти эквивалентная форма, приведённого выше,
      << (end - start) / 1s << "с.\n";  // но с использованием миллисекунд и секунд
                                        // соответственно
}

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

24 часа назад время было 2021-02-15 18:28:52.
Разные часы несопоставимы: 
 Системное время: 1666497022681282572нс
 Стабильное время: 413668317434475нс
Медленные расчёты заняли 2090448мкс ≈ 2090мс ≈ 2с.

Смотрите также

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