CKTIS / C++
std::chrono::year_month_day — datums en geldigheidscontroles
std::chrono::year_month_day slaat de velden jaar, maand en dag op. Een object maken garandeert geen geldige datum: ok() controleert ook de maandlengte en schrikkeljaren.
Versie: 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 stelt een datum voor met drie velden: std::chrono::year geeft het jaar aan, std::chrono::month de maand en std::chrono::day de dag van de maand, niet een duur in dagen. De constructor accepteert deze afzonderlijke typen; year(), month() en day() geven de bijbehorende velden terug.
De constructor slaat de velden op zonder niet-bestaande datums af te wijzen. std::chrono::year_month_day::ok() geeft alleen true terug als het jaar en de maand geldig zijn en de dag tussen 1 en de laatste dag van die maand in dat jaar ligt. Daarom is 2024-02-29 geldig, maar 2023-02-29 niet. Controleer ok() voordat je invoer als een geldige datum behandelt.
Het optellen van maanden of jaren kan een ongeldige datum opleveren; controleer het resultaat dus opnieuw. Om dagen op te tellen, converteer je een geldige datum naar std::chrono::sys_days, tel je std::chrono::days erbij op en maak je daarna een std::chrono::year_month_day. Conversie vervangt validatie niet: een ongeldige dag met een geldig jaar en een geldige maand wordt geteld vanaf het begin van de maand; bij een ongeldig jaar of een ongeldige maand is het resultaat niet gespecificeerd.
Voorbeelden
#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';
}
Resultaat
true false 2024 3 1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.