std::chrono::utc_clock

Определён в заголовочном файле `<chrono>`
class utc_clock;		(начиная с C++20)

Часы std::chrono::utc_clock — это часы, которые представляют всемирное координированное время (UTC). Они измеряют время с 00:00:00 UTC четверга, 1 января 1970 года, включая високосные секунды.

utc_clock соответствует требованиям к часам. Они не соответствуют требованиям к простым часам, если только реализация не может гарантировать, что now() не выбрасывает исключение.

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

Определено в пространстве имён `std::chrono`
template<class Duration> using utc_time = std::chrono::time_point<std::chrono::utc_clock, Duration>;		(начиная с C++20)
using utc_seconds = utc_time<std::chrono::seconds>;		(начиная с C++20)

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

Типы-члены

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

Константы-члены

constexpr bool is_steady

[static]

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

Функции-члены

now [static]	возвращает `std::chrono::time_point`, представляющую текущий момент времени (общедоступная статическая функция-член)
to_sys [static]	преобразует `utc_time` в `sys_time` (общедоступная статическая функция-член)
from_sys [static]	преобразует `sys_time` в `utc_time` (общедоступная статическая функция-член)

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

get_leap_second_info

(C++20)

получает сведения о вставке високосной секунды из объекта utc_time
(шаблон функции)

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

leap_second_info

(C++20)

сведения о вставке високосной секунды
(класс)

Примечания

Официальная эпоха UTC — 1 января 1972 года. utc_clock использует вместо этого 1 января 1970 года, чтобы соответствовать std::chrono::system_clock.

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