op_plus_assign.md

operator+=

• chrono[meta header]
• std::chrono[meta namespace]
• year_month[meta class]
• function[meta id-type]
• cpp20[meta cpp]

constexpr year_month& operator+=(const months& dm) noexcept; // (1) C++20
constexpr year_month& operator+=(const years& dy) noexcept;  // (2) C++20

概要

year_monthの値に対して加算の複合代入を行う。

• (1) : 月の時間間隔を加算する
• (2) : 年の時間間隔を加算する

パラメータの型が、カレンダー時間のmonth、yearではなく、時間間隔を表すmonths、yearsであることに注意。

テンプレートパラメータ制約

• (1) : monthsパラメータに指定した引数がyearsに変換可能である場合、yearsへの暗黙変換は、monthsへの暗黙変換よりも劣る

効果

• (1) : *this = *this + dm
• (2) : *this = *this + dy

戻り値

• (1), (2) : *this

例外

投げない

例

#include <iostream>
#include <chrono>

namespace chrono = std::chrono;
using namespace std::chrono_literals;

int main()
{
  chrono::year_month date = 2020y/3;

  date += chrono::months{1}; // 1ヶ月進める
  date += chrono::years{1};  // 1年進める

  std::cout << date << std::endl;
}

• 2020y[link /reference/chrono/year/op_y.md]

出力

2021/Apr

バージョン

言語

• C++20

処理系

• Clang: 8.0
• GCC: 11.1
• Visual C++: (2019 Update 3時点で実装なし)

参照

• LWG Issue 3260. year_month* arithmetic rejects durations convertible to years