std::formatter<std::chrono::gps_time>

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

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

• Если используется %Z, он заменяется на "GPS", расширенный до CharT.
• Если используется %z или его модифицированный вариант, будет отформатировано смещение 0min.
• Форматируемые дата и время эквивалентны тем, которые были бы отформатированы для std::chrono::sys_time, инициализированного с помощью std::chrono::sys_time<Duration>(tp.time_since_epoch()) + std::chrono::days(3657).

Специализация 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>

int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
    
    std::cout << std::format("The time of the Unix epoch was {0:%F}T{0:%R%z}.", epoch)
              << '\n';
}

The time of the Unix epoch was 1970-01-01T00:00+0000.

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

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

См. также