op_minus_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]

出力

2019/Feb

バージョン

言語

• C++20

処理系

• Clang: 8.0 [mark verified]
• GCC: 11.1 [mark verified]
• Visual C++: 2019 Update 3 [mark noimpl]

参照

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