WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::chrono::weekday — Wochentag und c_encoding()

std::chrono::weekday steht für einen Wochentag. Die Methode c_encoding() gibt unsigned zurück: Bei gültigen Werten steht 0 für Sonntag und 6 für Samstag. Prüfe ok(), bevor du Eingabewerte interpretierst.

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

Syntax

std::chrono::weekday{unsigned_value}
constexpr unsigned std::chrono::weekday::c_encoding() const noexcept;

std::chrono::weekday steht für einen Wochentag, nicht für ein vollständiges Datum. Die Methode std::chrono::weekday::c_encoding() hat die Signatur constexpr unsigned c_encoding() const noexcept; und gibt den gespeicherten Wert zurück: Bei einem gültigen Objekt ist Sonntag 0, Montag 1 und Samstag 6.

Der Konstruktor mit einem unsigned-Wert wandelt 7 in 0 um, wendet aber kein allgemeines Modulo 7 an. Daher ist weekday{8} ungültig: ok() gibt false zurück und c_encoding() gibt 8 zurück. Bei Argumenten außerhalb von [0, 255] ist der gespeicherte Wert nicht spezifiziert. Prüfe ok(), bevor du das Ergebnis als gültigen Wochentag behandelst.

Verwechsle diese Codierung nicht mit iso_encoding(): Bei gültigen Wochentagen verwendet die ISO-Codierung 1 für Montag und 7 für Sonntag. Das Beispiel zeigt beide Codierungen für Sonntag sowie ein ungültiges Objekt, ohne eine Uhr abzufragen oder Zeitzonen zu verwenden.

Beispiele

#include <chrono>
#include <iostream>

int main() {
    constexpr std::chrono::weekday sunday{7};
    constexpr std::chrono::weekday monday{1};
    constexpr std::chrono::weekday invalid{8};

    static_assert(sunday.ok() && sunday.c_encoding() == 0);
    static_assert(monday.ok() && monday.c_encoding() == 1);
    static_assert(!invalid.ok() && invalid.c_encoding() == 8);

    std::cout << sunday.c_encoding() << ' '
              << sunday.iso_encoding() << '\n';
    std::cout << monday.c_encoding() << '\n';
    std::cout << std::boolalpha << invalid.ok() << ' '
              << invalid.c_encoding() << '\n';
}

Ergebnis

0 7
1
false 8

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