std::formatter<std::chrono::year_month_day_last>

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

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

Специализация 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 с использованием целочисленного деления. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%EC` выводит альтернативное представление века по текущей локали.
`%y` `%Oy` `%Ey`	Выводит последние две цифры года. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%Oy` выводит альтернативное представление по текущей локали. Модифицированная команда `%Ey` выводит альтернативное представление смещения от `%EC` (только год).
`%Y` `%EY`	Выводит год в виде десятичного числа. Если результат имеет меньше четырех цифр, он дополняется нулями слева до четырех цифр. Модифицированная команда `%EY` выводит альтернативное полное представление года по текущей локали.
Месяц
`%b` `%h`	Выводит сокращенное имя месяца по текущей локали.
`%B`	Выводит полное имя месяца по текущей локали.
`%m` `%Om`	Выводит месяц в виде десятичного числа (январь — `01`). Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%Om` выводит альтернативное представление по текущей локали.
День
`%d` `%Od`	Выводит день месяца в виде десятичного числа. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%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, базирующегося на неделе. Если результат — однозначное число, перед ним добавляется 0.
`%G`	Выводит год по ISO 8601, базирующийся на неделе, в виде десятичного числа. Если результат имеет меньше четырех цифр, он дополняется нулями слева до четырех цифр.
`%V` `%OV`	Выводит номер недели по ISO 8601 в виде десятичного числа. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%OV` выводит альтернативное представление по текущей локали.
Неделя/день года
`%j`	Выводит номер дня в году в виде десятичного числа (1 января — `001`). Если результат имеет меньше трёх цифр, он дополняется нулями слева до трёх цифр.
`%U` `%OU`	Выводит номер недели в году в виде десятичного числа. Первая неделя года начинается с воскресенья, считается 01. Дни до неё в том же году - неделя 00. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%OU` выводит альтернативное представление по текущей локали.
`%W` `%OW`	Выводит номер недели в году в виде десятичного числа. Первая неделя года начинается с понедельника, считается 01. Дни до неё в том же году - неделя 00. Если результат — однозначное число, перед ним добавляется 0. Модифицированная команда `%OW` выводит альтернативное представление по текущей локали.
Дата
`%D`	Эквивалентно `"%m/%d/%y"`.
`%F`	Эквивалентно `"%Y-%m-%d"`.
`%x` `%Ex`	Выводит представление даты по текущей локали. Модифицированная команда `%Ex` выводит альтернативное представление даты по текущей локали.

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

Спецификатор преобразования	Объяснение
Время суток
`%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` записывает альтернативное представление даты и времени в соответствии с текущей локалью.

Пример

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

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам 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/year_month_day_last/formatter