CKTIS / C++
Datas e horas com std::chrono
std::chrono distingue durações, pontos no tempo e datas de calendário. Aprende os formatos %F e %R e a diferença entre um desfasamento UTC fixo e um fuso horário com nome.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
std::chrono::sys_days{std::chrono::year{2024}/2/29} + std::chrono::hours{9} + std::chrono::minutes{5}; std::format("{:%F %R}", tp)std::chrono distingue uma duração (duration), um ponto no tempo (time_point) e campos de calendário (year_month_day). sys_days representa um ponto na linha temporal de system_clock com precisão de um dia; adicionar hours e minutes produz um ponto mais preciso. year_month_day::ok() verifica se a data é válida, incluindo a validade do dia bissexto.
Em std::format("{:%F %R}", tp), %F equivale a %Y-%m-%d e %R equivale a %H:%M: hora no formato de 24 horas e minutos. %R omite os segundos sem alterar tp. Este formato não apresenta um desfasamento nem o nome do fuso; por isso, sem uma convenção acordada, o texto por si só não identifica um instante de forma única.
Desfasamento UTC fixo e fuso horário com nome: +02:00 especifica uma diferença constante em relação a UTC, não regras regionais. Um fuso com nome, como America/New_York, utiliza uma base de dados de regras e pode ter desfasamentos diferentes em datas diferentes. zoned_time associa um fuso a um ponto no tempo. Ao converter a hora local, as alterações do desfasamento podem criar horas inexistentes ou ambíguas; estes casos têm de ser tratados.
O exemplo utiliza uma data fixa e não consulta o relógio nem a base de dados de fusos horários. tp corresponde à hora do sistema, não à hora local. Esta entrada visa C++23; eel.is é um rascunho de trabalho em evolução, não uma publicação C++23 congelada. A opção do compilador do repositório não comprova o suporte da biblioteca padrão nem o do ambiente de execução de produção.
Exemplos
#include <chrono>
#include <format>
#include <iostream>
int main() {
using namespace std::chrono;
constexpr year_month_day date = year{2024}/2/29;
static_assert(date.ok());
constexpr auto tp = sys_days{date} + hours{9} + minutes{5};
std::cout << std::format("{:%F %R}\n", tp);
}
Resultado
2024-02-29 09:05
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.