std::chrono::operator+, std::chrono::operator- (std::chrono::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::month

Memberfunktionen

month::month

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

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

month::operator unsigned

month::ok

Nicht-Member-Funktionen

operator==operator<=>

operator+operator-

operator<<

from_stream

Hilfsklassen

formatter<std::chrono::month>

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

 

Definiert in Header <chrono>
constexpr std::chrono::month operator+( const std::chrono::month& m,                                         const std::chrono::months& ms ) noexcept;	(1)	(seit C++20)
constexpr std::chrono::month operator+( const std::chrono::months& ms,                                         const std::chrono::month& m ) noexcept;	(2)	(seit C++20)
constexpr std::chrono::month operator-( const std::chrono::month& m,                                         const std::chrono::months& ms ) noexcept;	(3)	(seit C++20)
constexpr std::chrono::months operator-( const std::chrono::month& m1,                                          const std::chrono::month& m2 ) noexcept;	(4)	(seit C++20)

1,2) Addiert ms.count() Monate zu m. Der Monatswert im Ergebnis wird berechnet, indem zuerst static_cast<long long>(unsigned(m)) + (ms.count() - 1) ausgewertet, dieses modulo 12 auf eine Ganzzahl im Bereich [​0​, 11] reduziert und dann 1 addiert wird.

3) Subtrahiert ms.count() Monate von m und gibt das Ergebnis zurück. Entspricht return m + -ms;.

4) Wenn m1.ok() und m2.ok() beide true sind, wird ein std::chrono::months-Wert m zurückgegeben, sodass m.count() im Bereich [​0​, 11] liegt und m2 + m == m1 gilt. Andernfalls ist der zurückgegebene Wert nicht spezifiziert.

Rückgabewert

1-3) Ein std::chrono::month, der einen wie oben beschriebenen Monats-Wert enthält.

4) Ein std::chrono::months, der die Distanz zwischen m1 und m2 repräsentiert.

Hinweise

Solange die Berechnung nicht überläuft, geben (1-3) immer einen gültigen Monat zurück, auch wenn m.ok() false ist.

Das Ergebnis der Subtraktion zweier month-Werte ist eine Dauer vom Typ std::chrono::months. Diese Einheiten repräsentieren die Länge des durchschnittlichen gregorianischen Monats, und die resultierende Dauer hat keine Beziehung zur Anzahl der Tage in den bestimmten Monaten, die von den Operanden repräsentiert werden. Zum Beispiel ist std::chrono::seconds(std::chrono::April - std::chrono::March) nicht die Anzahl der Sekunden im März (2678400s), sondern 2629746s (30,436875 Tage).

Beispiel

Führen Sie diesen Code aus

#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));
}

Siehe auch

operator++operator++(int)operator--operator--(int)	inkrementiert oder dekrementiert den Monat (public member function)
operator+=operator-=	addiert oder subtrahiert eine Anzahl von Monaten (public member function)