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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren 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) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender 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 E/A parse (C++20)

Zeitzone 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-Stil Datums- und Zeitfunktionen

 

std::chrono::year_month

Memberfunktionen

year_month::year_month

year_month::yearyear_month::month

year_month::operator+=year_month::operator-=

year_month::ok

Nicht-Member-Funktionen

operator==operator<=>

operator+operator-

operator<<

from_stream

Hilfsklassen

formatter<std::chrono::year_month>

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

 

constexpr std::chrono::year_month operator+( const std::chrono::year_month& ym,                                              const std::chrono::years& dy ) noexcept;	(1)	(seit C++20)
constexpr std::chrono::year_month operator+( const std::chrono::years& dy,                                              const std::chrono::year_month& ym ) noexcept;	(2)	(seit C++20)
constexpr std::chrono::year_month operator+( const std::chrono::year_month& ym,                                              const std::chrono::months& dm ) noexcept;	(3)	(seit C++20)
constexpr std::chrono::year_month operator+( const std::chrono::months& dm,                                              const std::chrono::year_month& ym ) noexcept;	(4)	(seit C++20)
constexpr std::chrono::year_month operator-( const std::chrono::year_month& ym,                                              const std::chrono::years& dy ) noexcept;	(5)	(seit C++20)
constexpr std::chrono::year_month operator-( const std::chrono::year_month& ym,                                              const std::chrono::months& dm ) noexcept;	(6)	(seit C++20)
constexpr std::chrono::months operator-( const std::chrono::year_month& ym1,                                          const std::chrono::year_month& ym2 ) noexcept;	(7)	(seit C++20)

1,2) Addiert dy.count() Jahre zu ym.

3,4) Addiert dm.count() Monate zu ym.

5) Subtrahiert dy.count() Jahre von ym.

6) Subtrahiert dm.count() Monate von ym.

7) Gibt die Differenz in Monaten zwischen den beiden Zeitpunkten zurück, die durch ym1 und ym2 repräsentiert werden.

Für Dauern, die sowohl in std::chrono::years als auch in std::chrono::months konvertierbar sind, werden die years-Überladungen (1,2,5) bevorzugt, falls der Aufruf sonst mehrdeutig wäre.

Rückgabewert

1,2) std::chrono::year_month(ym.year() + dy, ym.month())

3,4) Ein year_month-Wert z, so dass z - ym == dm und z.ok() == true.

5) ym + -dy

6) ym + -dm

7)
ym1.year() - ym2.year() + std::chrono::months(int(unsigned(ym1.month())) -
int(unsigned(ym2.month())))

Hinweise

Das Ergebnis der Subtraktion zweier year_month-Werte ist eine Dauer vom Typ std::chrono::months. Diese Einheit repräsentiert die Länge des durchschnittlichen Gregorianischen Monats (30,436875 Tage), und die resultierende Dauer hat keine Beziehung zur tatsächlichen Anzahl der Tage im betrachteten Zeitraum. Zum Beispiel ist das Ergebnis von 2017y/3 - 2017y/2 std::chrono::months(1), obwohl der Februar 2017 nur 28 Tage hat.

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <chrono>
 
int main()
{
    auto ym{std::chrono::year(2021)/std::chrono::July};
 
    ym = ym + std::chrono::months(14);
    assert(ym.month() == std::chrono::September);
    assert(ym.year() == std::chrono::year(2022));
 
    ym = ym - std::chrono::years(3);
    assert(ym.month() == std::chrono::month(9));
    assert(ym.year() == std::chrono::year(2019));
 
    ym = ym + (std::chrono::September - std::chrono::month(2));
    assert(ym.month() == std::chrono::April);
    assert(ym.year() == std::chrono::year(2020));
}

Siehe auch

operator+=operator-=

modifiziert das year_month um eine Anzahl von Monaten oder Jahren (public member function)