std::chrono::operator+, std::chrono::operator- (std::chrono::year_month_weekday)

From cppreference.com
 
哋它亢++
 
Utilities library
Language support
Type support (basic types, RTTI)
Library feature-test macros (哋它亢++20)
Dynamic memory management
Program utilities
Coroutine support (哋它亢++20)
Variadic functions
(哋它亢++20)
(哋它亢++26)
(哋它亢++11)
(哋它亢++20)
Debugging support
(哋它亢++26)
(哋它亢++26)
(哋它亢++26)
Three-way comparison
(哋它亢++20)(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)   
(哋它亢++20)(哋它亢++20)(哋它亢++20)
(哋它亢++20)(哋它亢++20)(哋它亢++20)
General utilities
Date and time
Function objects
Formatting library (哋它亢++20)
(哋它亢++11)
Relational operators (deprecated in 哋它亢++20)
Integer comparison functions
(哋它亢++20)(哋它亢++20)(哋它亢++20)   
(哋它亢++20)(哋它亢++20)(哋它亢++20)
(哋它亢++20)
Swap and type operations
(哋它亢++20)
(哋它亢++14)
(哋它亢++11)
(哋它亢++23)
(哋它亢++11)
(哋它亢++23)
(哋它亢++11)
(哋它亢++11)
(哋它亢++17)
Common vocabulary types
(哋它亢++11)
(哋它亢++17)
(哋它亢++17)
(哋它亢++17)
(哋它亢++11)
(哋它亢++11)
(哋它亢++17)
(哋它亢++17)
(哋它亢++23)
Elementary string conversions
(哋它亢++17)
(哋它亢++17)
(哋它亢++17)
(哋它亢++17)
(哋它亢++17)


 
Date and time utilities
Time point
(哋它亢++11)
(哋它亢++20)
(哋它亢++20)
Duration
(哋它亢++11)
Clocks
(哋它亢++11)
(哋它亢++11)
(哋它亢++11)      
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
Time of day
(哋它亢++20)(哋它亢++20)
(哋它亢++20)(哋它亢++20)
(哋它亢++20)

Calendars
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)      
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)(哋它亢++20)
Time zones
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)(哋它亢++20)(哋它亢++20)(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)
(哋它亢++20)

chrono I/O
(哋它亢++20)
C-style date and time
 
std::chrono::year_month_weekday
 
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::months& dm ) noexcept;
 (1) (since 哋它亢++20)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::months& dm,

               const std::chrono::year_month_weekday& ymwd ) noexcept;
 (2) (since 哋它亢++20)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::years& dy ) noexcept;
 (3) (since 哋它亢++20)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::years& dy,

               const std::chrono::year_month_weekday& ymwd ) noexcept;
 (4) (since 哋它亢++20)
constexpr std::chrono::year_month_weekday

    operator-( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::months& dm ) noexcept;
 (5) (since 哋它亢++20)
constexpr std::chrono::year_month_weekday

    operator-( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::years& dy ) noexcept;
 (6) (since 哋它亢++20)
1,2) Adds dm.count() months to the date represented by ymwd. The result has the same year() and month() as std::chrono::year_month(ymwd.year(), ymwd.month()) + dm and the same weekday() and index() as ymwd.
3,4) Adds dy.count() years to the date represented by ymwd. The result is equivalent to std::chrono::year_month_weekday(ymwd.year() + dy, ymwd.month(), ymwd.weekday_indexed()).
5) Subtracts dm.count() months from the date represented by ymwd. Equivalent to ymwd + -dm.
6) Subtracts dy.count() years from the date represented by ymwd. Equivalent to ymwd + -dy.

For durations that are convertible to both std::chrono::years and std::chrono::months, the years overloads (3,4,6) are preferred if the call would otherwise be ambiguous.

Notes

Even if ymwd.ok() is true, the resulting year_month_weekday may not represent a valid date if ymwd.index() is 5.

Example

Run this code
#include <cassert>
#include <chrono>
#include <iostream>
 
int main()
{
    auto ymwdi{1/std::chrono::Wednesday[1]/2021};
    std::cout << ymwdi << '\n';
 
    ymwdi = std::chrono::years(5) + ymwdi;
    // First Wednesday in January, 2026
    std::cout << ymwdi << '\n';
    assert(static_cast<std::chrono::year_month_day>(ymwdi) ==
           std::chrono::January/7/2026);
 
    ymwdi = ymwdi - std::chrono::months(6);
    // First Wednesday in July, 2025
    std::cout << ymwdi << '\n';
    assert(static_cast<std::chrono::year_month_day>(ymwdi) ==
           std::chrono::July/2/2025);
}

Output: 

2021/Jan/Wed[1]
2026/Jan/Wed[1]
2025/Jul/Wed[1]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/year_month_weekday/operator_arith_2&oldid=161710"