Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::chrono::year_month_day — dates et vérification de validité

std::chrono::year_month_day stocke les champs année, mois et jour. Construire un objet ne garantit pas une date valide : ok() vérifie aussi la durée du mois et les années bissextiles.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

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 représente une date à l’aide de trois champs : std::chrono::year désigne l’année, std::chrono::month le mois et std::chrono::day le jour du mois, et non une durée en jours. Son constructeur accepte ces types distincts ; year(), month() et day() renvoient les champs correspondants.

Le constructeur enregistre les champs sans rejeter les dates inexistantes. std::chrono::year_month_day::ok() renvoie true uniquement si l’année et le mois sont valides et si le jour est compris entre 1 et le dernier jour de ce mois pour cette année. Ainsi, 2024-02-29 est valide, mais 2023-02-29 ne l’est pas. Vérifiez ok() avant de considérer une entrée comme une date valide.

L’ajout de mois ou d’années peut produire une date invalide ; vérifiez donc à nouveau le résultat. Pour ajouter des jours, convertissez une date valide en std::chrono::sys_days, ajoutez std::chrono::days, puis construisez un std::chrono::year_month_day. La conversion ne remplace pas la validation : un jour invalide avec une année et un mois valides est compté à partir du début du mois ; une année ou un mois invalide rend le résultat non spécifié.

Exemples

#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';
}

Résultat

true false
2024 3 1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources