std::formatter<std::chrono::month_day>

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

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

Специализация 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) — глобальная локаль.

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

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

Спецификатор преобразования	Описание
`%%`	Выводит буквальный символ `%`.
`%n`	Выводит символ новой строки.
`%t`	Выводит символ горизонтальной табуляции.
Месяц
`%b` `%h`	Выводит сокращённое название месяца в соответствии с локалью.
`%B`	Выводит полное название месяца в соответствии с локалью.
`%m` `%Om`	Выводит месяц в виде десятичного числа (январь — это `01`). Если результат состоит из одной цифры, перед ней добавляется 0. Модифицированная команда `%Om` выводит альтернативное представление в соответствии с локалью.
День
`%d` `%Od`	Выводит день месяца в виде десятичного числа. Если результат состоит из одной десятичной цифры, перед ней добавляется 0. Модифицированная команда `%Od` выводит альтернативное представление в соответствии с локалью.
`%e` `%Oe`	Выводит день месяца в виде десятичного числа. Если результат состоит из одной десятичной цифры, перед ней добавляется пробел. Модифицированная команда `%Oe` выводит альтернативное представление в соответствии с локалью.

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

Спецификатор преобразования	Описание
Год
`%C` `%EC`	Выводит год, делённый на 100 с округлением вниз. Если результат состоит из одной десятичной цифры, перед ней добавляется 0. Модифицированная команда `%EC` выводит альтернативное представление столетия в соответствии с локалью.
`%y` `%Oy` `%Ey`	Выводит последние две десятичные цифры года. Если результат состоит из одной цифры, перед ней добавляется 0. Модифицированная команда `%Oy` выводит альтернативное представление в соответствии с локалью. Модифицированная команда `%Ey` выводит альтернативное представление смещения от `%EC` в соответствии с локалью (только год).
`%Y` `%EY`	Выводит год в виде десятичного числа. Если результат содержит менее четырёх цифр, слева добавляются нули, чтобы получилось четыре цифры. Модифицированная команда `%EY` выводит альтернативное полное представление года в соответствии с локалью.
День недели
`%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` выводит альтернативное представление даты в соответствии с локалью.
Время суток
`%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` выводит альтернативное представление даты и времени в соответствии с локалью.

Пример

#include <chrono>
#include <format>
#include <iostream>

int main()
{
    using namespace std::chrono_literals;
    constexpr std::chrono::month_day md{std::chrono::February / 29d};

    std::cout << "%B: " << std::format("{:%B}", md) << '\n'
              << "%d: " << std::format("{:%d}", md) << '\n';
}

Вывод:

%B: February
%d: 29

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

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