std::formatter<std::chrono::zoned_time>

Определено в заголовочном файле `<chrono>`
template< class Duration, class TimeZonePtr, class CharT > struct formatter<std::chrono::zoned_time<Duration, TimeZonePtr>, CharT> : std::formatter</local-time-format-t/<Duration>, CharT>		(с C++20)

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

Этот форматировщик использует std::chrono::local_time_format для форматирования.

Член parse унаследован от базового класса.

Пусть tp будет аргументом форматирования, ctx — контекст форматирования. Поведение члена format эквивалентно

auto info = tp.get_info();
return std::formatter</*local-time-format-t*/>::format(
    std::local_time_format(tp.get_local_time(), &info.abbrev, &info.offset), ctx);

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

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

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

fill-and-align (необязательно) width (необязательно) precision (необязательно) L(необязательно) chrono-spec (необязательно)

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

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

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

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

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

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

Спецификатор преобразования	Объяснение
`%%`	Выводит литеранльный символ `%`.
`%n`	Выводит символ новой строки.
`%t`	Выводит символ горизонтальной табуляции.
Год
`%C` `%EC`	Выводит год, делённый на 100 с помощью целочисленного деления. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%EC` выводит альтернативное представление века в соответствии с локалью.
`%y` `%Oy` `%Ey`	Выводит последние две цифры года. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%Oy` выводит альтернативное представление в соответствии с локалью. Модифицированная команда `%Ey` выводит альтернативное представление смещения от `%EC` (только год).
`%Y` `%EY`	Выводит год как десятичное число. Если результат содержит менее четырёх цифр, он дополняется нулями слева до четырёх цифр. Модифицированная команда `%EY` выводит альтернативное полное представление года в соответствии с локалью.
Месяц
`%b` `%h`	Выводит сокращённое название месяца в соответствии с локалью.
`%B`	Выводит полное название месяца в соответствии с локалью.
`%m` `%Om`	Выводит месяц как десятичное число (январь — `01`). Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%Om` выводит альтернативное представление в соответствии с локалью.
День
`%d` `%Od`	Выводит день месяца как десятичное число. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%Od` выводит альтернативное представление в соответствии с локалью.
`%e` `%Oe`	Выводит день месяца как десятичное число. Если результат — однозначное число, оно дополняется пробелом слева. Модифицированная команда `%Oe` выводит альтернативное представление в соответствии с локалью.
День недели
`%a`	Выводит сокращённое название дня недели в соответствии с локалью.
`%A`	Выводит полное название дня недели в соответствии с локалью.
`%u` `%Ou`	Выводит день недели по ISO как десятичное число (1-7), где понедельник — `1`. Модифицированная команда `%Ou` выводит альтернативное представление в соответствии с локалью.
`%w` `%Ow`	Выводит день недели как десятичное число (0-6), где воскресенье — `0`. Модифицированная команда `%Ow` выводит альтернативное представление в соответствии с локалью.
Год по ISO 8601 (неделя)
В ISO 8601 недели начинаются с понедельника, и первая неделя года должна удовлетворять следующим требованиям: Включает 4 января Включает первый четверг года
`%g`	Выводит последние две цифры года по ISO 8601 (неделя). Если результат — однозначное число, оно дополняется нулём слева.
`%G`	Выводит год по ISO 8601 (неделя) как десятичное число. Если результат содержит менее четырёх цифр, он дополняется нулями слева до четырёх цифр.
`%V` `%OV`	Выводит номер недели по ISO 8601 как десятичное число. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OV` выводит альтернативное представление в соответствии с локалью.
Неделя/день года
`%j`	Выводит день года как десятичное число (1 января — `001`). Если результат содержит менее трёх цифр, он дополняется нулями слева до трёх цифр.
`%U` `%OU`	Выводит номер недели года как десятичное число. Первое воскресенье года — это первый день недели 01. Дни в том же году до этого дня — это неделя 00. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OU` выводит альтернативное представление в соответствии с локалью.
`%W` `%OW`	Выводит номер недели года как десятичное число. Первый понедельник года — это первый день недели 01. Дни в том же году до этого дня — это неделя 00. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OW` выводит альтернативное представление в соответствии с локалью.
Дата
`%D`	Эквивалентно `"%m/%d/%y"`.
`%F`	Эквивалентно `"%Y-%m-%d"`.
`%x` `%Ex`	Выводит представление даты в соответствии с локалью. Модифицированная команда `%Ex` производит альтернативное представление даты в соответствии с локалью.
Время суток
`%H` `%OH`	Выводит час (24-часовой формат) как десятичное число. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OH` выводит альтернативное представление в соответствии с локалью.
`%I` `%OI`	Выводит час (12-часовой формат) как десятичное число. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OI` выводит альтернативное представление в соответствии с локалью.
`%M` `%OM`	Выводит минуту как десятичное число. Если результат — однозначное число, оно дополняется нулём слева. Модифицированная команда `%OM` выводит альтернативное представление в соответствии с локалью.
`%S` `%OS`	Выводит секунду как десятичное число. Если число секунд меньше 10, результат дополняется нулём слева. Если точность входных данных не может быть точно представлена секундами, формат — десятичное число с плавающей точкой в фиксированном формате и точностью, соответствующей точности входных данных (или до микросекундной точности, если преобразование в десятичные секунды с плавающей точкой не может быть выполнено в пределах 18 дробных цифр). Символ десятичной точки локализуется в соответствии с локалью. Модифицированная команда `%OS` выводит альтернативное представление в соответствии с локалью.
`%p`	Выводит эквивалент обозначений AM/PM, связанных с 12-часовым форматом, в соответствии с локалью.
`%R`	Эквивалентно `"%H:%M"`.
`%T`	Эквивалентно `"%H:%M:%S"`.
`%r`	Выводит время в 12-часовом формате в соответствии с локалью.
`%X` `%EX`	Выводит представление времени в соответствии с локалью. Модифицированная команда `%EX` выводит альтернативное представление времени в соответствии с локалью.
Часовой пояс
`%z` `%Ez` `%Oz`	Выводит смещение от UTC в формате ISO 8601. Например, `-0430` означает отставание от UTC на 4 часа 30 минут. Если смещение равно нулю, используется `+0000`. Модифицированные команды `%Ez` и `%Oz` вставляют разделитель `:` между часами и минутами (например, `-04:30`).
`%Z`	Выводит сокращение часового пояса.
Разное
`%c` `%Ec`	Выводит представление даты и времени в соответствии с локалью. Модифицированная команда `%Ec` выводит альтернативное представление даты и времени в соответствии с локалью.

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

Спецификатор преобразования	Объяснение
Счёт длительности
`%Q`	Выводит счёт тиков длительности, т.е. значение, полученное с помощью `count()`.
`%q`	Выводит суффикс единицы измерения длительности, как указано в `operator<<()`.

Пример

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

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

DR	Применено к	Поведение при публикации	Правильное поведение
P2372R3	C++20	`formatter` использовало глобальную локаль или передавало локаль	по умолчанию используется локаль `"C"`, если `L` отсутствует

См. также

format

(C++20)

сохраняет отформатированное представление аргументов в новой строке
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/zoned_time/formatter