CKTIS / C++
%F en %R in C++ chrono: vaste UTC-afwijking of benoemde tijdzone
`%F` toont de datum en `%R` toont uren en minuten in 24-uursnotatie. Ze maken de opgegeven waarde op; tijdzoneregels worden pas bij de omzetting toegepast.
Versie: 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) maken de specificaties na de dubbele punt een waarde uit std::chrono op. %F komt overeen met %Y-%m-%d (jaar, maand, dag). %R komt overeen met %H:%M (uren en minuten in 24-uursnotatie, met voorloopnullen). %R laat de seconden weg zonder af te ronden. Geen van beide specificaties zet de waarde om naar een andere tijdzone of toont een UTC-afwijking.
std::chrono::sys_seconds stelt een tijdstip voor waarvan de datum en tijd in UTC worden weergegeven. Voor een vaste afwijking van UTC+01:00 telt het voorbeeld std::chrono::hours{1} op bij de tijd sinds het referentienulpunt en maakt het met die uitkomst een std::chrono::local_seconds. Die waarde bevat de lokale datum en tijd, maar geen tijdzone of afwijking. EU_WARSAW is alleen een label van de toepassing: het is geen IANA-identificatie en past geen zomertijdregels toe.
Gebruik std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant} om de regels voor Warschau toe te passen. De IANA-tijdzonedatabase bepaalt de afwijking die op dat tijdstip geldt, rekening houdend met overgangen van en naar zomertijd. Het opzoeken kan std::runtime_error opleveren als de database niet beschikbaar is of de naam niet wordt gevonden.
Deze voorzieningen zijn sinds C++20 gestandaardiseerd en maken deel uit van ISO C++23, maar de ondersteuning verschilt per standaardbibliotheek. Het voorbeeld heeft chrono-opmaak nodig, maar geen tijdzonedatabase.
Voorbeelden
#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);
}Resultaat
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Tel je één uur op bij `2024-07-01 23:30:45` UTC, dan krijg je `2024-07-02 00:30:45`. `%R` toont `00:30`. De tweede regel toont het resultaat met een vaste afwijking, niet een omzetting volgens de regels voor Warschau.
Gerelateerde lessen
- C++ · Les 50 · Gevorderd · Versie: 3
Bronnen
- 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)