CKTIS / C++
%F e %R em C++ chrono: desvio UTC fixo e fuso horário identificado pelo nome
`%F` apresenta a data e `%R` apresenta as horas e os minutos no formato de 24 horas. Ambos formatam o valor recebido; as regras do fuso aplicam-se na conversão.
Versão: ISO C++23; implementation support may vary
Sintaxe
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}Em std::format("{:%F %R}", time_point), os especificadores a seguir aos dois pontos formatam um valor de std::chrono. %F equivale a %Y-%m-%d (ano, mês, dia), e %R equivale a %H:%M (horas e minutos no formato de 24 horas, com zeros à esquerda). %R omite os segundos sem arredondar. Nenhum dos dois especificadores converte entre fusos horários ou apresenta o desvio em relação a UTC.
std::chrono::sys_seconds representa um instante cuja data e hora são formatadas em UTC. Para apresentar um desvio fixo de UTC+01:00, o exemplo soma std::chrono::hours{1} ao tempo decorrido desde a época de referência e constrói um std::chrono::local_seconds a partir do resultado. Este valor contém a data e a hora locais, sem fuso nem desvio. EU_WARSAW é apenas uma etiqueta da aplicação: não é um identificador IANA nem aplica regras de hora de verão.
Para aplicar as regras de Varsóvia, usa std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. A base de dados de fusos horários da IANA determina o desvio em vigor nesse instante, tendo em conta as mudanças de hora. A pesquisa pode lançar std::runtime_error se a base de dados não estiver disponível ou se o nome não for encontrado.
Estas funcionalidades foram normalizadas em C++20 e fazem parte de ISO C++23, mas o suporte varia consoante a biblioteca padrão. O exemplo requer a formatação de chrono, mas não precisa de uma base de dados de fusos horários.
Exemplos
#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);
}Resultado
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Ao somar uma hora a `2024-07-01 23:30:45` UTC, obtém-se `2024-07-02 00:30:45`. `%R` apresenta `00:30`. A segunda linha mostra o resultado do desvio fixo, não de uma conversão segundo as regras de Varsóvia.
Lições relacionadas
- C++ · Lição 50 · Avançado · Versão: 3
Fontes
- 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)