NAME¶

std::chrono::weekday - std::chrono::weekday

Synopsis¶

Defined in header <chrono>
class weekday; (since C++20)
inline constexpr std::chrono::weekday Sunday{0}; (since C++20)
inline constexpr std::chrono::weekday Monday{1}; (since C++20)
inline constexpr std::chrono::weekday Tuesday{2}; (since C++20)
inline constexpr std::chrono::weekday Wednesday{3}; (since C++20)
inline constexpr std::chrono::weekday Thursday{4}; (since C++20)
inline constexpr std::chrono::weekday Friday{5}; (since C++20)
inline constexpr std::chrono::weekday Saturday{6}; (since C++20)

The class weekday represent a day of the week in the proleptic Gregorian calendar.
Its normal range is [0, 6], for Sunday through Saturday, but it can hold any value
in the range [0, 255]. Seven named constants are predefined in the std::chrono
namespace for the seven days of the week.

weekday is a TriviallyCopyable StandardLayoutType.

Member functions¶

constructor constructs a weekday
(public member function)
operator++
operator++(int) increments or decrements the weekday
operator-- (public member function)
operator--(int)
operator+= adds or subtracts a number of days
operator-= (public member function)
c_encoding retrieves the stored weekday value
iso_encoding retrieves ISO 8601 weekday value
(public member function)
ok checks if the stored weekday value is valid
(public member function)
convenience syntax for constructing a weekday_indexed or
operator[] weekday_last from this weekday
(public member function)

Nonmember functions

operator== compares two weekday values
(C++20) (function)
operator+ performs arithmetic on weekdays
operator- (function)
(C++20)
operator<< outputs a weekday into a stream
(C++20) (function template)
from_stream parses a weekday from a stream according to the provided format
(C++20) (function template)

Helper classes¶

std::formatter<std::chrono::weekday> formatting support for weekday
(C++20) (class template specialization)
std::hash<std::chrono::weekday> hash support for std::chrono::weekday
(C++26) (class template specialization)

Example¶

// Run this code

#include <chrono>
#include <iostream>

int main()
{
std::chrono::weekday x{42 / 13};
std::cout << x++ << '\n';
std::cout << x << '\n';
std::cout << ++x << '\n';
}

Output:¶

Wed
Thu
Fri

See also¶

weekday_indexed represents the n^th weekday of a month
(C++20) (class)