std::formatter<std::chrono::zoned_time>, std::chrono::local_time_format

template< class Duration, class TimeZonePtr, class CharT >
struct formatter<std::chrono::zoned_time<Duration, TimeZonePtr>, CharT>
    : std::formatter</*local-time-format-t*/
                         <std::common_type_t<Duration,
                                             std::chrono::seconds>>, CharT>

template< class Duration >
/*local-time-format-t*/<Duration>
    local_time_format( const std::chrono::local_time<Duration>& tp,
                       const std::string* abbrev = nullptr,
                       const std::chrono::seconds* offset_sec = nullptr );

template< class Duration >
struct /*local-time-format-t*/
{
    std::chrono::local_time<Duration> /*time*/;
    const std::string* /*abbrev*/;
    const std::chrono::seconds* /*offset_sec*/;
};

template< class Duration, class CharT >
struct formatter</*local-time-format-t*/<Duration>, CharT>;

• Член parse наследуется от базового класса.
• Пусть tp — аргумент форматирования, а ctx — контекст форматирования; поведение члена format эквивалентно следующему:

using common_duration_type = std::common_type_t<Duration, std::chrono::seconds>; using formatter_type = std::formatter<local-time-format-t <common_duration_type>; std::chrono::sys_info info = tp.get_info(); return formatter_type::format({tp.get_local_time(), &info.abbrev, &info.offset_sec}), ctx);

• abbrev содержит аббревиатуру часового пояса.
• offset_sec содержит смещение относительно UTC.
• time содержит все остальные необходимые сведения.

• Если chrono-spec не указан, результат эквивалентен использованию %F %T %Z в качестве chrono-spec .
• Если используется %Z, он заменяется на *f.abbrev, если f.abbrev не является нулевым указателем; в противном случае выбрасывается исключение типа std::format_error.
• Если используется %z или изменённый вариант %z, он заменяется на *f.offset_sec, если f.offset_sec не является нулевым указателем; в противном случае выбрасывается исключение типа std::format_error.

Специализация 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()) с помощью imbue, после чего os.str() копируется в выходной буфер с дополнительным заполнением и корректировками в соответствии со спецификаторами формата.

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

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

Пример

Сообщения об ошибках стандарта

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

См. также