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.