Spec-Zone.ru › C++

std::formatter<std::chrono::local_time>, std::chrono::local_time_format

Определено в заголовке <chrono> 
template< class Duration, class CharT >
struct formatter<std::chrono::local_time<Duration>, CharT>;
 (1) 
template< class Duration >
struct /*local-time-format-t*/ {
    std::chrono::local_time<Duration> time; // exposition only
    const std::string* abbrev;              // exposition only
    const std::chrono::seconds* offset;     // exposition only
};
 (2) (только для демонстрации*) 
template< class Duration >
/*local-time-format-t*/<Duration>
    local_time_format( const std::chrono::local_time<Duration>& tp,
                       const std::string* abbrev = nullptr,
                       const std::chrono::seconds* offset_sec = nullptr );
 (3) 
template< class Duration, class CharT >
struct formatter</*local-time-format-t*/<Duration>, CharT>;
 (4)

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

1) Если используется %Z, %z или модифицированная версия %z, будет брошено исключение std::format_error.
2-4) Функция local_time_format возвращает значение неопределённого типа, содержащее местное время, смещение и аббревиатуру часового пояса.
При форматировании объекта f этого неопределённого типа, если используется %Z, оно заменяется на *f.abbrev, расширенное до CharT, если f.abbrev не равно нулю; в противном случае будет брошено исключение std::format_error. Если используется %z или его модифицированная версия, будет отформатировано смещение *f.offset_sec, если f.offset_sec не равно нулю; в противном случае будет брошено исключение std::format_error.

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 генерирует альтернативное представление даты в соответствии с локалью.
Время суток
%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 выводит альтернативное представление времени в соответствии с локалью.
Часовой пояс
%z
%Ez
%Oz 		Выводит смещение от UTC в формате ISO 8601. Например, -0430 означает 4 часа 30 минут отставания от UTC. Если смещение равно нулю, используется +0000.

Изменённые команды %Ez и %Oz вставляют разделитель : между часами и минутами (например, -04:30).
%Z Выводит сокращение часового пояса.
Разное
%c
%Ec 		Выводит представление даты и времени в соответствии с локалью.

Изменённая команда %Ec выводит альтернативное представление даты и времени в соответствии с локалью.

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

Спецификатор преобразования
 Объяснение
Счётчик продолжительности
%Q Выводит счётчик тиков продолжительности, т.е. значение, полученное с помощью count().
%q Выводит суффикс единицы измерения продолжительности, как указано в operator<<().

Пример

См. также

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API