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

 

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::year_month_day

メンバ関数

year_month_day::year_month_day

year_month_day::operator+=year_month_day::operator-=

year_month_day::yearyear_month_day::monthyear_month_day::day

year_month_day::operator sys_daysyear_month_day::operator local_days

year_month_day::ok

非メンバ関数

operator==operator<=>

operator+operator-

operator<<

from_stream

ヘルパークラス

formatter<std::chrono::year_month_day>

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

 

ヘッダー <chrono> で定義
constexpr std::chrono::year_month_day operator+( const std::chrono::year_month_day& ymd,                                                  const std::chrono::months& dm                                                ) noexcept;		(C++20以降)
constexpr std::chrono::year_month_day operator+( const std::chrono::months& dm,                                                  const std::chrono::year_month_day& ymd                                                ) noexcept;		(C++20以降)
constexpr std::chrono::year_month_day operator+( const std::chrono::year_month_day& ymd,                                                  const std::chrono::years& dy                                                ) noexcept;		(C++20以降)
constexpr std::chrono::year_month_day operator+( const std::chrono::years& dy,                                                  const std::chrono::year_month_day& ymd                                                ) noexcept;		(C++20以降)
constexpr std::chrono::year_month_day operator-( const std::chrono::year_month_day& ymd,                                                  const std::chrono::months& dm                                                ) noexcept;		(C++20以降)
constexpr std::chrono::year_month_day operator-( const std::chrono::year_month_day& ymd,                                                  const std::chrono::years& dy                                                ) noexcept;		(C++20以降)

1,2) ymd で表される日付に dm.count() ヶ月を加算します。結果は、ymd と同じ day() を持ち、std::chrono::year_month(ymd.year(), ymd.month()) + dm と同じ year() および month() を持ちます。

3,4) ymd で表される日付に dy.count() 年を加算します。結果は、std::chrono::year_month_day(ymd.year() + dy, ymd.month(), ymd.day() と同等です。

5) ymd で表される日付から dm.count() ヶ月を減算します。ymd + -dm と同等です。

6) ymd で表される日付から dy.count() 年を減算します。ymd + -dy と同等です。

std::chrono::yearsとstd::chrono::monthsの両方に変換可能な期間の場合、呼び出しが曖昧になる可能性があるときは、yearsのオーバーロード (3,4,6) が優先されます。

注意

ymd.ok() が true であっても、ymd.day() が 29、30、または 31 の場合、結果の year_month_day は有効な日付を表さない可能性があります。

例

このコードを実行

#include <chrono>
#include <iostream>
 
int main()
{
    std::cout << std::boolalpha;
 
    auto ymd{std::chrono::day(1)/std::chrono::July/2021};
 
    ymd = ymd + std::chrono::months(4);
    std::cout << (ymd.month() == std::chrono::November) << ' '
              << (ymd.year() == std::chrono::year(2021)) << ' ';
 
    ymd = ymd - std::chrono::years(10);
    std::cout << (ymd.month() == std::chrono::month(11)) << ' '
              << (ymd.year() == std::chrono::year(2011)) << '\n';
}

出力

true true true true