std::formatter<std::chrono::sys_time>

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

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

• Если используется %Z, он заменяется на "UTC", расширенный до CharT.
• Если используется %z или его модифицированный вариант, будет отформатировано смещение 0min.

Специализация 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++.

См. также