std::formatter<std::chrono::utc_time>

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

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

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

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

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

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

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

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

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

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

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

Если не указано иное, при пустом chrono-spec объект 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++.

См. также