WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen