Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::chrono::year_month_day — fechas y comprobación de validez

std::chrono::year_month_day almacena los campos de año, mes y día. Crear un objeto no garantiza una fecha válida: ok() también comprueba la duración del mes y los años bisiestos.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

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 una fecha mediante tres campos: std::chrono::year indica el año, std::chrono::month el mes y std::chrono::day el día del mes, no una duración en días. Su constructor acepta estos tipos distintos; year(), month() y day() devuelven los campos correspondientes.

El constructor almacena los campos sin rechazar las fechas inexistentes. std::chrono::year_month_day::ok() devuelve true solo cuando el año y el mes son válidos y el día está entre 1 y el último día de ese mes en ese año. Por tanto, 2024-02-29 es válida, pero 2023-02-29 no. Comprueba ok() antes de tratar una entrada como una fecha válida.

Sumar meses o años puede producir una fecha no válida, así que vuelve a comprobar el resultado. Para sumar días, convierte una fecha válida a std::chrono::sys_days, suma std::chrono::days y después construye un std::chrono::year_month_day. La conversión no sustituye a la validación: un día no válido con año y mes válidos se cuenta desde el comienzo del mes; si el año o el mes no son válidos, el resultado no está especificado.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes