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.