Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | chrono‎ | year
 
 
Utilities library
General utilities
Date and time
Function objects
Formatting library (C++20)
(C++11)
Relational operators (deprecated in C++20)
Integer comparison functions
(C++20)
Swap and type operations
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Common vocabulary types
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

Elementary string conversions
(C++17)
(C++17)
Stacktrace
 
Date and time utilities
(C++11)
(C++11)
Time of day
(C++20)



(C++20)(C++20)(C++20)(C++20)
Clocks
(C++20)
                                             
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Calendars
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Time zones
(C++20)
(C++20)
(C++20)
(C++20)
C-style date and time
 
 
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};

Contents

[edit] Parameters

(none)

[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 [-32767, 32767], the actual stored value is unspecified.

[edit] Example

#include <iostream>
#include <chrono>
 
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++;
    std::cout << static_cast<int>(y) << '\n';
}

Possible output:

true true
-32768

[edit] See also

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