Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes