std::formatter<std::chrono::hh_mm_ss>

template< class CharT >
struct formatter<std::chrono::hh_mm_ss, CharT>;

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

Специализация std::formatter обычно не используется напрямую, а применяется через функции форматирования.

Спецификация формата

Спецификация формата имеет следующий вид

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

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

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

Пример

#include <chrono>
#include <format>
#include <iostream>
using namespace std::literals;

int main()
{
    std::chrono::hh_mm_ss c{16h + 32min + 10s};

    std::cout << "%R: " << std::format("{:%R}", c) << '\n'
              << "%T: " << std::format("{:%T}", c) << '\n';
}

%R: 16:32
%T: 16:32:10

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

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также