std::chrono::operator+, std::chrono::operator- (std::chrono::month)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

日付と時刻ライブラリ

時間点 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 時間間隔 duration (C++11) クロック system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 時刻 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

カレンダー day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

タイムゾーン tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C スタイルの日付と時刻

 

std::chrono::month

メンバ関数

month::month

month::operator++month::operator--

month::operator+=month::operator-=

month::operator unsigned

month::ok

非メンバ関数

operator==operator<=>

operator+operator-

operator<<

from_stream

ヘルパークラス

formatter<std::chrono::month>

hash<std::chrono::month> (C++26)

 

ヘッダー <chrono> で定義
constexpr std::chrono::month operator+( const std::chrono::month& m,                                         const std::chrono::months& ms ) noexcept;	(1)	(C++20以降)
constexpr std::chrono::month operator+( const std::chrono::months& ms,                                         const std::chrono::month& m ) noexcept;	(2)	(C++20以降)
constexpr std::chrono::month operator-( const std::chrono::month& m,                                         const std::chrono::months& ms ) noexcept;	(3)	(C++20以降)
constexpr std::chrono::months operator-( const std::chrono::month& m1,                                          const std::chrono::month& m2 ) noexcept;	(4)	(C++20以降)

1,2) ms.count()ヶ月を m に加算します。結果に含まれる月値は、まず static_cast<long long>(unsigned(m)) + (ms.count() - 1) を評価し、それを12で割った余りを [​0​, 11] の範囲に縮小し、最後に1を加えることで計算されます。

3) ms.count()ヶ月を m から減算し、結果を返します。return m + -ms; と等価です。

4) m1.ok() と m2.ok() が両方とも true の場合、m.count() が [​0​, 11] の範囲にあり、かつ m2 + m == m1 となる std::chrono::months 値 m を返します。それ以外の場合、返される値は未指定です。

返り値

1-3) 上記のように計算された月値を含む std::chrono::month。

4) m1 と m2 の間の差を表す std::chrono::months。

注意

計算がオーバーフローしない限り、m.ok() が false であっても、(1-3) は常に有効な月を返します。

2つのmonth値を減算した結果は、std::chrono::months 型の期間になります。その期間単位は、平均的なグレゴリオ暦の月の日数を表し、結果の期間は、オペランドによって表される特定の月の実際の日数とは関係ありません。例えば、std::chrono::seconds(std::chrono::April - std::chrono::March) は、3月の日数（2678400s）ではなく、2629746s（30.436875日）になります。

例

このコードを実行

#include <cassert>
#include <chrono>
 
int main()
{
    std::chrono::month m{6};
 
    m = m + std::chrono::months(2);
    assert(m == std::chrono::month(8));
 
    m = m - std::chrono::months(3);
    assert(m == std::chrono::month(5));
 
    constexpr std::chrono::months ms = std::chrono::month(8) - std::chrono::month(6);
    static_assert(ms == std::chrono::months(2));
}

関連項目

operator++operator++(int)operator--operator--(int)	月をインクリメントまたはデクリメントします (public member function)
operator+=operator-=	月数を加算または減算します (public member function)