Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::chrono::weekday

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].

NotebookLM
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

constructs a weekday
(public member function)
increments or decrements the weekday
(public member function)
adds or subtracts a number of days
(public member function)
retrieves the stored weekday value
retrieves ISO 8601 weekday value
(public member function)
checks if the stored weekday value is valid
(public member function)
convenience syntax for constructing a weekday_indexed or weekday_last from this weekday
(public member function)

Nonmember functions

compares two weekday values
(function)
performs arithmetic on weekdays
(function)
outputs a weekday into a stream
(function template)
parses a weekday from a stream according to the provided format
(function template)

Helper classes

formatting support for weekday
(class template specialization)
hash support for std::chrono::weekday
(class template specialization)

Example

example.cpp
#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

represents the nth weekday of a month
(class)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.