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