CKTIS / C++
%F и %R в C++ chrono: фиксирано отместване спрямо UTC и именувана часова зона
`%F` извежда датата, а `%R` — часовете и минутите в 24-часов формат. Те форматират подадената стойност; правилата на часовата зона се прилагат при преобразуването.
Версия: ISO C++23; implementation support may vary
Синтаксис
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}В std::format("{:%F %R}", time_point) спецификаторите след двоеточието форматират стойност от std::chrono. %F е равностоен на %Y-%m-%d (година, месец, ден), а %R — на %H:%M (часове и минути в 24-часов формат с водещи нули). %R пропуска секундите, без да закръгля. Нито един от двата спецификатора не преобразува между часови зони и не извежда отместването спрямо UTC.
std::chrono::sys_seconds представя момент, чиято дата и час се форматират в UTC. За показване с фиксирано отместване UTC+01:00 примерът добавя std::chrono::hours{1} към изминалото време от началото на референтната епоха и конструира std::chrono::local_seconds от резултата. Тази стойност съдържа местната дата и час, но не съдържа часова зона или отместване. EU_WARSAW е само етикет на приложението: той не е идентификатор на IANA и не прилага правила за лятното часово време.
За да приложиш правилата за Варшава, използвай std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. Базата данни на IANA за часовите зони определя валидното за момента отместване, като отчита преминаването към лятно часово време и обратно. Търсенето може да предизвика изключение std::runtime_error, ако базата е недостъпна или името не бъде намерено.
Тези възможности са стандартизирани в C++20 и са част от ISO C++23, но поддръжката зависи от стандартната библиотека. Примерът изисква форматиране на стойности от chrono, но не и база данни за часови зони.
Примери
#include <chrono>
#include <format>
#include <iostream>
int main() {
using namespace std::chrono;
const sys_seconds instant = sys_days{year{2024}/July/1}
+ hours{23} + minutes{30} + seconds{45};
const local_seconds fixed_local{instant.time_since_epoch() + hours{1}};
std::cout << std::format("UTC: {:%F %R}\n", instant)
<< std::format("EU_WARSAW (fixed UTC+01:00): {:%F %R}\n",
fixed_local);
}Резултат
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Добавянето на един час към `2024-07-01 23:30:45` UTC дава `2024-07-02 00:30:45`. `%R` показва `00:30`. Вторият ред показва резултата от фиксираното отместване, а не от преобразуване по правилата за Варшава.
Свързани уроци
- C++ · Урок 50 · Напреднало · Версия: 3
Източници
- C++ working draft — Formatting [time.format]
- C++ working draft — Local time [time.clock.local]
- C++ working draft — Time zones [time.zone]
- C++ working draft — Class template zoned_time [time.zone.zonedtime]
- C++ working draft — Time zone database access [time.zone.db.access]
- C++ working draft — Class tzdb [time.zone.db.tzdb]
- C++ Draft International Standard (N4860)