std::chrono::year_month_day:: operator+=, std::chrono::year_month_day:: operator-=
From cppreference.net
<
cpp
|
chrono
|
year month day
|
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
関連項目
|
(C++20)
|
year_month_day
に年数または月数を加算または減算する
(関数) |