Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::chrono::year_month_day — data a kontrola platnosti

std::chrono::year_month_day ukládá pole roku, měsíce a dne. Vytvoření objektu nezaručuje platné datum: ok() kontroluje také délku měsíce a přestupné roky.

Verze: 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 představuje datum pomocí tří polí: std::chrono::year označuje rok, std::chrono::month měsíc a std::chrono::day den v měsíci, nikoli dobu trvání ve dnech. Konstruktor přijímá tyto odlišné typy; year(), month() a day() vracejí odpovídající pole.

Konstruktor ukládá pole, aniž by odmítal neexistující data. std::chrono::year_month_day::ok() vrací true pouze tehdy, když jsou rok a měsíc platné a den leží mezi 1 a posledním dnem daného měsíce v daném roce. Datum 2024-02-29 je tedy platné, ale 2023-02-29 nikoli. Než začnete vstup považovat za platné datum, ověřte ok().

Přičtení měsíců nebo let může vytvořit neplatné datum, proto výsledek znovu ověřte. Chcete-li přičíst dny, převeďte platné datum na std::chrono::sys_days, přičtěte std::chrono::days a poté vytvořte std::chrono::year_month_day. Převod nenahrazuje ověření: neplatný den při platném roku a měsíci se počítá od začátku měsíce; při neplatném roce nebo měsíci není výsledek specifikován.

Příklady

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

Výsledek

true false
2024 3 1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje