std::formatter<std::chrono::tai_time>

template< class Duration, class CharT >
struct formatter<std::chrono::tai_time<Duration>, CharT>;

Специализация std::formatter, определяющая правила форматирования для std::chrono::tai_time.

• Если используется %Z, он заменяется на "TAI", расширенный до CharT.
• Если используется %z или его модифицированный вариант, форматируется смещение 0min.
• Форматируемые дата и время эквивалентны тем, которые форматируются для std::chrono::sys_time, инициализированного с помощью std::chrono::sys_time<Duration>(tp.time_since_epoch()) - std::chrono::days(4383).

Специализация std::formatter обычно не используется напрямую, а применяется через функции форматирования.

Спецификация формата

Спецификация формата имеет следующий вид

заполнение-и-выравнивание, ширина и точность имеют тот же смысл, что и в стандартной спецификации формата. Точность допустима только для типов std::chrono::duration, у которых тип представления Rep является типом с плавающей точкой; в противном случае выбрасывается исключение std::format_error.

Локаль, используемая для форматирования, определяется следующим образом:

• локаль L по умолчанию, если она не указана в спецификации формата;
• в противном случае локаль, обозначенная объектом std::locale, переданным функции форматирования, если таковой имеется;
• в противном случае (если L указана, но функции форматирования не передан объект std::locale) используется глобальная локаль.

Если кодировка строковых литералов (обычных или широких) является формой кодирования Unicode, а локаль входит в определяемый реализацией набор локалей, каждая замена, зависящая от локали, выполняется так, как если бы заменяющая последовательность символов преобразовывалась в кодировку литерала.

Спецификация-chrono состоит из одного или нескольких спецификаторов преобразования и обычных символов (кроме {, } и %). Спецификация-chrono должна начинаться со спецификатора преобразования. Все обычные символы записываются в выходные данные без изменений. Каждый немодифицированный спецификатор преобразования начинается с символа %, за которым следует символ, определяющий поведение спецификатора. Некоторые спецификаторы преобразования имеют модифицированную форму, в которой после символа % вставляется символ-модификатор E или O. Каждый спецификатор преобразования заменяется в выходных данных соответствующими символами, как описано ниже.

Если не указано иное, при пустой спецификации-chrono объект chrono форматируется так, как если бы он был передан в поток с помощью операции вывода в объект os типа std::basic_ostringstream<CharT>, в который установлена локаль форматирования (одна из std::locale::classic(), переданный объект std::locale и std::locale::global()), с последующим копированием os.str() в выходной буфер с дополнительным заполнением и корректировками согласно спецификаторам формата.

Доступны следующие спецификаторы формата:

Следующие спецификаторы распознаются, но приводят к выбрасыванию исключения std::format_error:

Пример

#include <chrono>
#include <format>
#include <iostream>

int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
    
    std::cout << std::format("The time of the Unix epoch was {0:%F}T{0:%R%z}.", epoch)
              << '\n';
}

The time of the Unix epoch was 1970-01-01T00:00+0000.

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроспективно к ранее опубликованным стандартам C++.

См. также