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 обычно не используется напрямую, а используется через функции форматирования.

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

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

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

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

Следующие спецификаторы распознаются, но вызовут 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++.

См. также