5. operator+

最終更新日時(UTC):
が更新

履歴 編集

function
<chrono>

std::chrono::operator+(C++20)

namespace std::chrono {
  constexpr year_month_day operator+(const year_month_day& ymd, const months& dm) noexcept; // (1) C++20
  constexpr year_month_day operator+(const months& dm, const year_month_day& ymd) noexcept; // (2) C++20

  constexpr year_month_day operator+(const year_month_day& ymd, const years& dy) noexcept;  // (3) C++20
  constexpr year_month_day operator+(const years& dy, const year_month_day& ymd) noexcept;  // (4) C++20
}

概要

year_month_dayの加算を行う。

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

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

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

戻り値

  • (1) :

return (ymd.year() / ymd.month() + dm) / ymd.day();

  • (2) :

return ymd + dm;

  • (3) :

return (ymd.year() + dy) / ymd.month() / ymd.day();

  • (4) :

return ymd + dy;

例外

投げない

備考

  • 日の値が29以上である場合、加算により年月の値によっては範囲外の日となり、ok() == falseになる可能性がある

例

#include <cassert>
#include <chrono>

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

int main()
{
  assert(2020y/3/1 + chrono::months{1} == 2020y/4/1);
  assert(2020y/3/1 + chrono::years{1} == 2021y/3/1);
}

出力

バージョン

言語

  • C++20

処理系

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

参照