std::chrono::time_zone::to_sys

 

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

Memberfunktionen

time_zone::name

time_zone::get_info

time_zone::to_sys

time_zone::to_local

Nicht-Member-Funktionen

operator==operator<=>

 

template< class Duration > auto to_sys( const std::chrono::local_time<Duration>& tp ) const     -> std::chrono::sys_time<std::common_type_t<Duration, std::chrono::seconds>>;	(1)	(seit C++20)
template< class Duration > auto to_sys( const std::chrono::local_time<Duration>& tp, std::chrono::choose z ) const     -> std::chrono::sys_time<std::common_type_t<Duration, std::chrono::seconds>>;	(2)	(seit C++20)

Konvertiert die local_time tp in dieser Zeitzone in die entsprechende sys_time.

1) Wirft eine Ausnahme, wenn die Konvertierung mehrdeutig ist oder wenn tp eine nicht existierende Zeit darstellt.

2) Löst Mehrdeutigkeiten gemäß dem Wert von z auf.

• Wenn z == std::chrono::choose::earliest, wird die frühere sys_time zurückgegeben.
• Wenn z == std::chrono::choose::latest, wird die spätere sys_time zurückgegeben.

Wenn tp eine nicht existierende Zeit zwischen zwei UTC time_points darstellt, sind diese beiden time_points gleich und dieser time_point wird zurückgegeben.

Rückgabewert

Das UTC-Äquivalent von tp gemäß den Regeln dieser Zeitzone.

Ausnahmen

1) Wirft

• std::chrono::ambiguous_local_time, wenn die Konvertierung mehrdeutig ist.
• std::chrono::nonexistent_local_time, wenn tp eine nicht existierende Zeit darstellt.

Hinweise

Die Präzision des Ergebnisses beträgt mindestens std::chrono::seconds und ist feiner, wenn das Argument eine feinere Präzision aufweist.

Mehrdeutige und nicht existierende lokale Zeiten können als Ergebnis von Zeitzonenübergängen (wie z. B. Sommerzeit) auftreten. Zum Beispiel existiert "2016-03-13 02:30:00" in der Zeitzone "America/New_York" nicht, während "2016-11-06 01:30:00" in dieser Zeitzone zwei UTC-Zeitpunkte entsprechen kann: 2016-11-06 05:30:00 UTC und 2016-11-06 06:30:00 UTC.