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

Специализация 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 <iostream>
#include <format>
#include <chrono>
 
int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
 
    std::cout << std::format("Время эпохи Unix было {0:%F}T{0:%R%z}.", epoch);
}

Время эпохи Unix было 1970-01-01T00:00+0000.

[править] Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

[править] Смотрите также