std::formatter<std::chrono::file_time>

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

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

• Если используется %Z, он заменяется на "UTC", расширенный до CharT.
• Если используется %z или его модифицированный вариант, будет отформатировано смещение 0min.
• Отформатированные дата и время эквивалентны тем, которые форматируются для std::chrono::clock_cast<std::chrono::system_clock>(tp) или std::chrono::clock_cast<std::chrono::utc_clock>(tp), где tp представляет аргумент форматирования.

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

См. также