std::chrono::year::operator++, std::chrono::year::operator--

< cpp‎ | chrono‎ | year
Utilities library
Language support
Type support (basic types, RTTI)
Library feature-test macros (C++20)
Dynamic memory management
Program utilities
Coroutine support (C++20)
Variadic functions
Debugging support
Three-way comparison
General utilities
Date and time
Function objects
Formatting library (C++20)
Relational operators (deprecated in C++20)
Integer comparison functions
Swap and type operations
Common vocabulary types
Elementary string conversions

constexpr std::chrono::year& operator++() noexcept;
(1) (since C++20)
constexpr std::chrono::year operator++( int ) noexcept;
(2) (since C++20)
constexpr std::chrono::year& operator--() noexcept;
(3) (since C++20)
constexpr std::chrono::year operator--( int ) noexcept;
(4) (since C++20)

Adds or subtracts 1 from the year value.

1,2) Performs *this += std::chrono::years{1};.
3,4) Performs *this -= std::chrono::years{1};.


[edit] Parameters


[edit] Return value

1,3) A reference to this year after modification.
2,4) A copy of the year made before modification.

[edit] Notes

If the result would be outside the range [-3276732767], the actual stored value is unspecified.

[edit] Example

#include <chrono>
#include <iostream>
int main()
    std::cout << std::boolalpha;
    std::chrono::year y{2020};
    std::cout << (++y == std::chrono::year(2021)) << ' ';
    std::cout << (--y == std::chrono::year(2020)) << '\n';
    using namespace std::literals::chrono_literals;
    y = 32767y;
    y++; //← unspecified, see ↑ Notes ↑
    std::cout << static_cast<int>(y) << '\n';

Possible output:

true true

[edit] See also

adds or subtracts a number of years from a year
(public member function) [edit]
performs arithmetic on years
(function) [edit]