CKTIS / C++
%F e %R in C++ chrono: scostamento fisso da UTC e fuso orario con nome
`%F` mostra la data e `%R` mostra ore e minuti nel formato a 24 ore. Entrambi formattano il valore ricevuto; le regole del fuso si applicano durante la conversione.
Versione: ISO C++23; implementation support may vary
Sintassi
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}In std::format("{:%F %R}", time_point), gli specificatori dopo i due punti formattano un valore di std::chrono. %F equivale a %Y-%m-%d (anno, mese, giorno), mentre %R equivale a %H:%M (ore e minuti nel formato a 24 ore, con zeri iniziali). %R omette i secondi senza arrotondare. Nessuno dei due specificatori converte tra fusi orari o mostra lo scostamento da UTC.
std::chrono::sys_seconds rappresenta un istante la cui data e ora sono formattate in UTC. Per mostrare uno scostamento fisso di UTC+01:00, l’esempio aggiunge std::chrono::hours{1} al tempo trascorso dall’epoca di riferimento e costruisce un valore std::chrono::local_seconds a partire dal risultato. Questo valore contiene la data e l’ora locali, senza fuso né scostamento. EU_WARSAW è solo un’etichetta dell’applicazione: non è un identificatore IANA e non applica le regole dell’ora legale.
Per applicare le regole di Varsavia, usa std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. Il database IANA dei fusi orari determina lo scostamento in vigore in quell’istante, tenendo conto dei passaggi all’ora legale e viceversa. La ricerca può lanciare std::runtime_error se il database non è disponibile o il nome non è presente.
Queste funzionalità sono standard da C++20 e fanno parte di ISO C++23, ma il supporto varia a seconda della libreria standard. L’esempio richiede la formattazione di chrono, ma non un database dei fusi orari.
Esempi
#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);
}Risultato
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Aggiungendo un’ora a `2024-07-01 23:30:45` UTC si ottiene `2024-07-02 00:30:45`. `%R` mostra `00:30`. La seconda riga mostra il risultato dello scostamento fisso, non di una conversione secondo le regole di Varsavia.
Lezioni correlate
- C++ · Lezione 50 · Avanzato · Versione: 3
Fonti
- 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)