Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::chrono::year_month_day — data i sprawdzanie poprawności

std::chrono::year_month_day przechowuje pola roku, miesiąca i dnia. Samo utworzenie obiektu nie gwarantuje poprawnej daty: metoda ok() sprawdza również długość miesiąca i lata przestępne.

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

Składnia

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 reprezentuje datę za pomocą trzech pól: std::chrono::year oznacza rok, std::chrono::month miesiąc, a std::chrono::day dzień miesiąca, nie liczbę dni trwania. Konstruktor przyjmuje te osobne typy; metody year(), month() i day() zwracają odpowiednie pola.

Konstruktor zapisuje pola bez odrzucania nieistniejących dat. std::chrono::year_month_day::ok() zwraca true tylko wtedy, gdy rok i miesiąc są poprawne, a dzień mieści się między 1 a ostatnim dniem danego miesiąca w danym roku. Dlatego 2024-02-29 jest poprawne, ale 2023-02-29 nie. Sprawdzaj ok() przed traktowaniem danych wejściowych jako poprawnej daty.

Dodawanie miesięcy lub lat może dać niepoprawną datę; wynik trzeba ponownie sprawdzić. Do dodawania dni przekształć poprawną datę na std::chrono::sys_days, dodaj std::chrono::days, a następnie utwórz std::chrono::year_month_day. Konwersja nie zastępuje walidacji: niepoprawny dzień przy poprawnym roku i miesiącu jest przeliczany względem początku miesiąca, a przy niepoprawnym roku lub miesiącu wynik jest nieokreślony.

Przykłady

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

Wynik

true false
2024 3 1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła