std::formatter<std::chrono::weekday>

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

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

Специализация 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`	Записывает символ горизонтальной табуляции.
День недели
`%a`	Записывает сокращённое название дня недели из локали.
`%A`	Записывает полное название дня недели из локали.
`%u` `%Ou`	Записывает номер дня недели по ISO в десятичном формате (1-7), где понедельник — `1`. Модифицированная команда `%Ou` записывает альтернативное представление из локали.
`%w` `%Ow`	Записывает номер дня недели в десятичном формате (0-6), где воскресенье — `0`. Модифицированная команда `%Ow` записывает альтернативное представление из локали.

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

Спецификатор преобразования	Объяснение
Год
`%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` записывает альтернативное представление в соответствии с локалью.
Год по ISO 8601, основанный на неделе
В соответствии с ISO 8601 недели начинаются с понедельника, и первая неделя года должна удовлетворять следующим требованиям: Включает 4 января Включает первый четверг года
`%g`	Записывает две последние цифры года по ISO 8601, основанного на неделе. Если результат — однозначное число, перед ним добавляется 0.
`%G`	Записывает год по ISO 8601, основанный на неделе, как десятичное число. Если результат содержит меньше четырёх цифр, он дополняется нулями слева до четырёх цифр.
`%V` `%OV`	Записывает номер недели года по ISO 8601 как десятичное число. Первая неделя года начинается с первого воскресенья. Дни до этого в той же году попадают в неделю 00. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OV` записывает альтернативное представление в соответствии с локалью.
Неделя/день года
`%j`	Записывает номер дня года как десятичное число (1 января — `001`). Если результат содержит меньше трёх цифр, он дополняется нулями слева до трёх цифр.
`%U` `%OU`	Записывает номер недели года как десятичное число. Первая неделя года начинается с первого воскресенья. Дни до этого в той же году попадают в неделю 00. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OU` записывает альтернативное представление в соответствии с локалью.
`%W` `%OW`	Записывает номер недели года как десятичное число. Первая неделя года начинается с первого понедельника. Дни до этого в той же году попадают в неделю 00. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OW` записывает альтернативное представление в соответствии с локалью.
Дата
`%D`	Эквивалентно `"%m/%d/%y"`.
`%F`	Эквивалентно `"%Y-%m-%d"`.
`%x` `%Ex`	Записывает представление даты в соответствии с локалью. Изменённая команда `%Ex` генерирует альтернативное представление даты в соответствии с локалью.
Время суток
`%H` `%OH`	Записывает час (24-часовой формат) как десятичное число. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OH` записывает альтернативное представление в соответствии с локалью.
`%I` `%OI`	Записывает час (12-часовой формат) как десятичное число. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OI` записывает альтернативное представление в соответствии с локалью.
`%M` `%OM`	Записывает минуту как десятичное число. Если результат — однозначное число, перед ним добавляется 0. Изменённая команда `%OM` записывает альтернативное представление в соответствии с локалью.
`%S` `%OS`	Записывает секунду как десятичное число. Если количество секунд меньше 10, результат дополняется 0 слева. Если точность входных данных не может быть точно представлена секундами, то формат — десятичное число с плавающей точкой, имеющее фиксированный формат и точность, соответствующую точности входных данных (или до микросекунд, если преобразование в десятичные секунды с плавающей точкой невозможно в пределах 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++.

Отчёт об ошибке	Применено к	Поведение при публикации	Корректное поведение
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/weekday/formatter