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.