CKTIS / C++
std::chrono::year_month_day — Datumsangaben und Gültigkeitsprüfung
std::chrono::year_month_day speichert die Felder Jahr, Monat und Tag. Das Erstellen eines Objekts garantiert kein gültiges Datum: ok() prüft auch die Monatslänge und Schaltjahre.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
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 stellt ein Datum mit drei Feldern dar: std::chrono::year bezeichnet das Jahr, std::chrono::month den Monat und std::chrono::day den Tag des Monats, keine Dauer in Tagen. Der Konstruktor nimmt diese unterschiedlichen Typen entgegen; year(), month() und day() geben die entsprechenden Felder zurück.
Der Konstruktor speichert die Felder, ohne nicht existierende Daten zurückzuweisen. std::chrono::year_month_day::ok() gibt nur dann true zurück, wenn Jahr und Monat gültig sind und der Tag zwischen 1 und dem letzten Tag dieses Monats in diesem Jahr liegt. Daher ist 2024-02-29 gültig, 2023-02-29 jedoch nicht. Prüfe ok(), bevor du Eingaben als gültiges Datum behandelst.
Das Addieren von Monaten oder Jahren kann ein ungültiges Datum ergeben; prüfe das Ergebnis daher erneut. Um Tage zu addieren, wandle ein gültiges Datum in std::chrono::sys_days um, addiere std::chrono::days und erstelle anschließend ein std::chrono::year_month_day. Die Umwandlung ersetzt keine Validierung: Ein ungültiger Tag bei gültigem Jahr und Monat wird ab Monatsanfang gezählt; bei ungültigem Jahr oder Monat ist das Ergebnis nicht spezifiziert.
Beispiele
#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';
}
Ergebnis
true false 2024 3 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.