Namespaces
Variants

std::chrono::year_month_day:: operator+=, std::chrono::year_month_day:: operator-=

From cppreference.net

constexpr std:: chrono :: year_month_day &
operator + = ( const std:: chrono :: years & dy ) const noexcept ;
(1) (C++20以降)
constexpr std:: chrono :: year_month_day &
operator + = ( const std:: chrono :: months & dm ) const noexcept ;
(2) (C++20以降)
constexpr std:: chrono :: year_month_day &
operator - = ( const std:: chrono :: years & dy ) const noexcept ;
(3) (C++20以降)
constexpr std:: chrono :: year_month_day &
operator - = ( const std:: chrono :: months & dm ) const noexcept ;
(4) (C++20以降)

この時間点 * this を、期間 dy または dm によって変更します。

1) 次と等価: * this = * this + dy ;
2) 次と等価: * this = * this + dm ;
3) 次と等価: * this = * this - dy ;
4) 次と等価: * this = * this - dm ;

期間が std::chrono::years std::chrono::months の両方に変換可能な場合、呼び出しが曖昧になる可能性があるときは years のオーバーロード (1,3) が優先されます。

#include <cassert>
#include <chrono>
#include <iostream>
int main()
{
    constexpr auto monthsInYear{12};
    auto ymd{std::chrono::day(1)/std::chrono::July/2020};
    std::cout << "#1 " << ymd << '\n';
    ymd -= std::chrono::years(10);
    std::cout << "#2 " << ymd << '\n';
    assert(ymd.month() == std::chrono::July);
    assert(ymd.year() == std::chrono::year(2010));
    ymd += std::chrono::months(10 * monthsInYear + 11);
    std::cout << "#3 " << ymd << '\n';
    assert(ymd.month() == std::chrono::month(6));
    assert(ymd.year() == std::chrono::year(2021));
    // ymd += months の「オーバーフロー」ケースの処理
    ymd = std::chrono::May/31/2021; // ok
    std::cout << "#4 " << ymd << '\n';
    assert(ymd.ok());
    ymd += std::chrono::months{1}; // 不正な日付: 6月は30日しかない
    std::cout << "#5 " << ymd << '\n';
    assert(not ymd.ok());
    assert(ymd == std::chrono::June/31/2021);
    // 月の最終日(6月30日)にスナップ:
    const auto ymd1 = ymd.year()/ymd.month()/std::chrono::last;
    std::cout << "#6 " << ymd1 << '\n';
    assert(ymd1.ok());
    assert(ymd1 == std::chrono::June/30/2021);
    // 次の月(7月1日)へのオーバーフロー(sys_days への変換/変換元を経由):
    const std::chrono::year_month_day ymd2 = std::chrono::sys_days{ymd};
    std::cout << "#7 " << ymd2 << '\n';
    assert(ymd2.ok());
    assert(ymd2 == std::chrono::July/1/2021);
}

出力:

#1 2020-07-01
#2 2010-07-01
#3 2021-06-01
#4 2021-05-31
#5 2021-06-31 is not a valid date
#6 2021/Jun/last
#7 2021-07-01

関連項目

year_month_day に年数または月数を加算または減算する
(関数)