std::chrono::system_clock

Определено в заголовке `<chrono>`
class system_clock;		(с C++11)

Класс std::chrono::system_clock представляет собой системные реальные часы.

Он может быть не монотонным: в большинстве систем системное время может быть скорректировано в любой момент. Это единственные C++ часы, которые могут сопоставить свои временные точки со временем C-стиля.

std::chrono::system_clock соответствует требованиям TrivialClock.

Эпоха `system_clock` не определена, но большинство реализаций используют время Unix (т.е. время с 00:00:00 по координированному всемирному времени (UTC), четверг, 1 января 1970 года, без учета високосных секунд).	(до C++20)
`system_clock` измеряет время Unix (т.е. время с 00:00:00 по координированному всемирному времени (UTC), четверг, 1 января 1970 года, без учета високосных секунд).	(с C++20)

Семейство временных точек

Определено в пространстве имен `std::chrono`
template<class Duration> using sys_time = std::chrono::time_point<std::chrono::system_clock, Duration>;		(с C++20)
using sys_seconds = sys_time<std::chrono::seconds>;		(с C++20)
using sys_days = sys_time<std::chrono::days>;		(с C++20)

operator<<(std::chrono::sys_time) (C++20)	выполняет вывод потока на `sys_time` (шаблон функции)
from_stream(std::chrono::sys_time) (C++20)	анализирует `sys_time` из потока в соответствии с предоставленным форматом (шаблон функции)
std::formatter<std::chrono::sys_time> (C++20)	форматирование поддержки `sys_time` (специализация шаблона класса)

Типы членов

Тип члена	Определение
`rep`	целочисленный арифметический тип, представляющий количество тиков в продолжительности часов
`period`	тип `std::ratio`, представляющий период тика часов, в секундах
`duration`	`std::chrono::duration<rep, period>`, способный представлять отрицательные продолжительности
`time_point`	`std::chrono::time_point<std::chrono::system_clock>`

Постоянные члены

constexpr bool is_steady

[static]

true если время между тиками всегда постоянно, т.е. вызовы now() возвращают значения, которые монотонно увеличиваются даже в случае некоторой внешней корректировки часов, в противном случае false
(общедоступная статическая константа члена)

Функции членов

now [static]	возвращает `std::chrono::time_point`, представляющую текущий момент времени (общедоступная статическая функция члена)
to_time_t [static]	преобразует точку времени системных часов в `std::time_t` (общедоступная статическая функция члена)
from_time_t [static]	преобразует `std::time_t` в точку времени системных часов (общедоступная статическая функция члена)

Примечания

Значение времени system_clock может быть внутренне скорректировано операционной системой в любой момент, например, из-за синхронизации NTP или изменения пользователем системных часов. Однако летнее/зимнее время и изменения часовых поясов на нее не влияют, поскольку оно основано на часовом поясе UTC.

См. также

steady_clock (C++11)	монотонные часы, которые никогда не будут корректироваться (класс)
high_resolution_clock (C++11)	часы с самым коротким доступным периодом тика (класс)

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