std::chrono::month(3)

🌸 NAME 🌸

okay so this is std::chrono::month — yes, literally std::chrono::month — straight from the C++ Standard Libary (that's the manual name, bestie, and we're keeping the spelling 💅). It's the calendar-month class and it is lowkey iconic. 🗓️✨

✨ Synopsis ✨

Defined in header <chrono>
class month;                                       (since C++20)
inline constexpr std::chrono::month January{1};    (since C++20)
inline constexpr std::chrono::month February{2};   (since C++20)
inline constexpr std::chrono::month March{3};      (since C++20)
inline constexpr std::chrono::month April{4};      (since C++20)
inline constexpr std::chrono::month May{5};        (since C++20)
inline constexpr std::chrono::month June{6};       (since C++20)
inline constexpr std::chrono::month July{7};       (since C++20)
inline constexpr std::chrono::month August{8};     (since C++20)
inline constexpr std::chrono::month September{9};  (since C++20)
inline constexpr std::chrono::month October{10};   (since C++20)
inline constexpr std::chrono::month November{11};  (since C++20)
inline constexpr std::chrono::month December{12};  (since C++20)

So what's the vibe? The class month represents a month in a year. Its normal range is [1, 12], but it may hold any number in [0, 255] — yes, the whole byte range is invited to the party. Twelve named constants are predefined in the std::chrono namespace for the twelve months of the year. Also, month is a TriviallyCopyable StandardLayoutType — no cap, that's just the type lore. 🫶

🎀 Member functions 🎀

• constructor — constructs a month (public member function).
• operator++, operator++(int) — increments or decrements the month (public member function).
• operator--, operator--(int) — increments or decrements the month (public member function).
• operator+=, operator-= — adds or subtracts a number of months (public member function).
• operator unsigned — retrieves the stored month value (public member function).
• ok — checks if the stored month value is in the normal range (public member function).

💫 Nonmember functions 💫

• operator== — compares two month values.
• operator<=> — (function) (C++20). That's literally how it's listed; don't come for me. 💀
• operator+, operator- — performs arithmetic on months (function) (C++20).
• operator<< — outputs a month into a stream (C++20) (function template).
• from_stream — parses a month from a stream according to the provided format (C++20) (function template).

🧚 Helper classes 🧚

• std::formatter<std::chrono::month> — formatting support for month (C++20) (class template specialization).
• std::hash<std::chrono::month> — hash support for std::chrono::month (C++26) (class template specialization).

---

💖 that's the whole tea, bestie. source: http://cppreference.com · version/date: 2024.06.10 · std::chrono::month(3) 💖✨