std::formatter<std::chrono::year_month_day>

Определено в заголовке `<chrono>`
template< class CharT > struct formatter<std::chrono::year_month_day, CharT>;		(с C++20)

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

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

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

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

выравнивание-заполнитель (необязательно) ширина (необязательно) точность (необязательно) L(необязательно) chrono-спецификация (необязательно)

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

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

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

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

Если chrono-спецификация пуста, объект 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 в виде десятичного числа. Первое воскресенье года — первый день недели 01. Дни того же года до этого относятся к неделе 00. Если результат — однозначное число, он предваряется нулём. Модифицированная команда `%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` создаёт альтернативное представление даты в локали.

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

END_OF_DOCUMENT_MARKER

Спецификатор преобразования	Объяснение
Время суток
`%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` выводит альтернативное представление времени для текущей локали.
Подсчёт длительности
`%Q`	Выводит счётчик тиков длительности, то есть значение, полученное через `count()`.
`%q`	Выводит суффикс единицы длительности, как указано в `operator<<()`.
Временная зона
`%z` `%Ez` `%Oz`	Выводит смещение от UTC в формате ISO 8601. Например, `-0430` соответствует 4 часам 30 минутам назад от UTC. Если смещение равно нулю, используется `+0000`. Изменённые команды `%Ez` и `%Oz` вставляют `:` между часами и минутами (например, `-04:30`).
`%Z`	Выводит сокращение названия временной зоны.
Разное
`%c` `%Ec`	Выводит представление даты и времени для текущей локали. Изменённая команда `%Ec` выводит альтернативное представление даты и времени для текущей локали.

Пример

См. также

format

(C++20)

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

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