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

CKTIS / C++

std::chrono::year_month_day — datas e verificação da validade

std::chrono::year_month_day armazena os campos de ano, mês e dia. Criar um objeto não garante uma data válida: ok() também verifica a duração do mês e os anos bissextos.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

std::chrono::year_month_day{std::chrono::year{y}, std::chrono::month{m}, std::chrono::day{d}}
constexpr bool std::chrono::year_month_day::ok() const noexcept;

std::chrono::year_month_day representa uma data através de três campos: std::chrono::year indica o ano, std::chrono::month o mês e std::chrono::day o dia do mês, não uma duração em dias. O construtor aceita estes tipos distintos; year(), month() e day() devolvem os campos correspondentes.

O construtor armazena os campos sem rejeitar datas inexistentes. std::chrono::year_month_day::ok() devolve true apenas quando o ano e o mês são válidos e o dia está entre 1 e o último dia desse mês nesse ano. Assim, 2024-02-29 é válida, mas 2023-02-29 não é. Verifique ok() antes de tratar uma entrada como uma data válida.

Adicionar meses ou anos pode produzir uma data inválida, por isso volte a verificar o resultado. Para adicionar dias, converta uma data válida em std::chrono::sys_days, adicione std::chrono::days e, em seguida, crie um std::chrono::year_month_day. A conversão não substitui a validação: um dia inválido com ano e mês válidos é contado a partir do início do mês; se o ano ou o mês for inválido, o resultado não é especificado.

Exemplos

#include <chrono>
#include <iostream>

int main() {
    using namespace std::chrono;

    constexpr year_month_day leap{year{2024}, month{2}, day{29}};
    constexpr year_month_day invalid{year{2023}, month{2}, day{29}};
    static_assert(leap.ok());
    static_assert(!invalid.ok());

    constexpr year_month_day next{sys_days{leap} + days{1}};
    static_assert(next == year_month_day{year{2024}, month{3}, day{1}});

    std::cout << std::boolalpha
              << leap.ok() << ' ' << invalid.ok() << '\n';
    std::cout << int(next.year()) << ' '
              << unsigned(next.month()) << ' '
              << unsigned(next.day()) << '\n';
}

Resultado

true false
2024 3 1

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