CKTIS / C++
%F und %R in C++ chrono: fester UTC-Versatz und benannte Zeitzone
`%F` gibt das Datum aus, `%R` die Stunden und Minuten im 24-Stunden-Format. Beide formatieren den übergebenen Wert; Zeitzonenregeln gelten bei der Umrechnung.
Version: ISO C++23; implementation support may vary
Syntax
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}In std::format("{:%F %R}", time_point) formatieren die Angaben nach dem Doppelpunkt einen Wert aus std::chrono. %F entspricht %Y-%m-%d (Jahr, Monat, Tag), %R entspricht %H:%M (Stunden und Minuten im 24-Stunden-Format mit führenden Nullen). %R lässt die Sekunden weg, ohne zu runden. Keine der beiden Angaben rechnet zwischen Zeitzonen um oder gibt einen UTC-Versatz aus.
std::chrono::sys_seconds bezeichnet einen Zeitpunkt, dessen Datum und Uhrzeit in UTC formatiert werden. Für den festen Versatz UTC+01:00 addiert das Beispiel std::chrono::hours{1} zur seit der Epoche verstrichenen Zeit und erzeugt daraus einen Wert vom Typ std::chrono::local_seconds. Dieser enthält das lokale Datum und die lokale Uhrzeit, aber weder Zeitzone noch Versatz. EU_WARSAW ist lediglich eine Anwendungsbezeichnung: Sie ist kein IANA-Bezeichner und wendet keine Sommerzeitregeln an.
Für die Regeln von Warschau verwende std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. Die IANA-Zeitzonendatenbank bestimmt den zu diesem Zeitpunkt geltenden Versatz einschließlich der Sommerzeitwechsel. Die Suche kann std::runtime_error auslösen, wenn die Datenbank nicht verfügbar ist oder der Name nicht gefunden wird.
Diese Funktionen wurden mit C++20 standardisiert und sind Teil von ISO C++23. Die Unterstützung hängt von der Standardbibliothek ab. Das Beispiel benötigt die chrono-Formatierung, aber keine Zeitzonendatenbank.
Beispiele
#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);
}Ergebnis
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Eine Stunde nach `2024-07-01 23:30:45` UTC ist `2024-07-02 00:30:45`. `%R` zeigt `00:30` an. Die zweite Zeile zeigt den festen Versatz und keine Umrechnung nach den Regeln von Warschau.
Zugehörige Lektionen
- C++ · Lektion 50 · Fortgeschritten · Version: 3
Quellen
- 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)