Teilen über


<chrono>

Schließen Sie den Standardheader ein <chrono> , um Klassen und Funktionen zu definieren, die Zeitdauern und Zeit instants darstellen und bearbeiten.

Ab Visual Studio 2015 wurde die Implementierung steady_clock geändert, um die C++-Standardanforderungen für Beständigkeit und Monotonität zu erfüllen:

  • steady_clock basiert jetzt auf QueryPerformanceCounter()
  • high_resolution_clock ist jetzt eine Typedef für steady_clock die Microsoft C++-Implementierung, steady_clock::time_point ist jetzt für typedef chrono::time_point<steady_clock>. Dies ist jedoch nicht unbedingt der Fall für andere Implementierungen.

Anforderungen

Header: <chrono>

Regionale Gesetzgeber nehmen gelegentlich Änderungen an Zeitzonen vor, und eine internationale Standardsstelle gibt an, wann neue Schaltsekunden berücksichtigt werden sollen. Eine Datenbank dieser Änderungen wurde Windows 10 hinzugefügt. Speziell:

Funktion Clientversion Serverversion
Schalte zweite Datenbankaktualisierungen Windows 10 ab Version 1809 Windows Server 2019 oder höher
Unterstützung für Zeitzonen Windows 10, Version 1903/19H1 oder höher Windows Server 2022 oder höher

Die Verwendung der Zeitzoneneinrichtungen in älteren Versionen von Windows führt zu einem Laufzeitfehler.

Namespace:std

Calendrical-Typen

Name Beschreibung
common_type-Struktur Beschreibt Spezialisierungen der Klassenvorlage common_type für Instanziationen von duration und time_point.
day-Klasse Ein Tag des Monats. Beispielsweise der 25. Tag des Monats.
duration-Klasse Ein Zeitintervall.
duration_values-Struktur Stellt bestimmte Werte für den duration-Vorlagenparameter Rep bereit.
hh_mm_ss-Klasse Teilt eine duration in Stunden:Minuten:Sekunden auf.
last_spec Wird verwendet, um das letzte Element in einem Monat anzugeben, z. B. den letzten Tag der Woche eines Monats (der letzte Dienstag vom Februar 2020) oder den letzten Tag eines Monats (der letzte Tag von April 2019).
leap_second-Klasse Ein Datum und ein Wert für einen eingefügten Schaltz12.
leap_second_info-Struktur Die von get_leap_second_info zurückgegebenen Daten.
month-Klasse Ein Monat eines Jahres. Beispiel: Juli.
month_day-Klasse Ein bestimmter Tag eines bestimmten Monats. Beispiel: 30. Juli.
month_day_last-Klasse Der letzte Tag eines Monats.
month_weekday-Klasse Der n. Wochentag eines bestimmten Monats.
month_weekday_last-Klasse Der n. Wochentag eines bestimmten Monats.
time_point-Klasse Ein Zeitpunkt.
weekday-Klasse Ein Wochentag.
weekday_last-Klasse Der letzte Wochentag eines Monats.
weekday_indexed-Klasse Kombiniert einen Wochentag mit einem Index, der den Wochentag des Monats darstellt.
year-Klasse Ein Jahr im gregorianischen Kalender.
year_month-Klasse Ein Jahr und Monat. Der Tag ist nicht angegeben.
year_month_day-Klasse Ein Jahr, Monat und Tag.
year_month_day_last-Klasse Der letzte Tag eines bestimmten Monats und Jahres.
year_month_weekday-Klasse Ein bestimmtes Jahr, Monat und n. Wochentag des Monats.
year_month_weekday_last-Klasse Ein bestimmtes Jahr, Monat und letzter Wochentag des Monats.

Uhren

Name Beschreibung
file_clock-Klasse Ein Alias für die Uhr, für die verwendet std::filesystem::file_time_typewird, um Dateizeitstempel auszudrücken.
gps_clock-Klasse Eine Uhr, die GPS-Zeit hält. Misst die Zeit ab dem ersten Sonntag vom Januar 1980 um 00:00:00 UTC.
high_resolution_clock-Struktur Eine Uhr mit einem Nanosekunden-Teilstrich.
local_t-Struktur Eine Pseudouhr, die als Argument für die time_point Vorlage verwendet wird, um anzugeben, dass die time_point lokale Uhrzeit darstellt.
steady_clock-Struktur Eine steady Uhr. Diese Uhr wird zum Messen von Zeitintervallen bevorzugt.
system_clock-Struktur Eine Uhr, die auf der Echtzeituhr des Systems basiert.
tai_clock-Klasse Measures International Atomic Time (TAI) ab Donnerstag, 1. Januar 1958 um 00:00:00 Uhr. Diese Uhr berücksichtigt keine Schaltsekunden.
utc_clock-Klasse Misst die Zeit seit 00:00:00 UTC am Donnerstag, dem 1. Januar 1970. Diese Uhr macht Schaltsekunden und ist der zeitübliche Standard, der auf der ganzen Welt verwendet wird.

Zeitzonen

Name Beschreibung
choose Eine Enumeration, die angibt, wie die mehrdeutige Konvertierung einer in ein local_time .sys_time
local_info Stellt eine Low-Level-Schnittstelle zu Zeitzoneninformationen zum Ergebnis der Konvertierung eines local_time in ein sys_time.
sys_info Stellt eine Low-Level-Schnittstelle zu Zeitzoneninformationen zum Ergebnis der Konvertierung eines sys_time in ein local_time.
time_zone-Klasse Alle Zeitzonenübergänge für einen bestimmten geografischen Bereich.
time_zone_link-Klasse Ein alternativer Name für ein time_zone.
tzdb-Struktur Stellt eine Kopie der Zeitzonendatenbank dar.
tzdb_list-Klasse Eine Singletonliste von Zeitzonendatenbanken.
zoned_time-Klasse Eine Kopplung von einer time_zone und einer time_point mit einer angegebenen Genauigkeit.
zoned_traits-Struktur Wird verwendet, um einer anderen Standardzeitzone eine zoned_timeandere Standardzeitzone zuzuordnen und optional einen benutzerdefinierten Namen dieser Standardzeitzone zuzuordnen.

Ausnahmen

Name Beschreibung
ambiguous_local_time Der Fehler wird ausgelöst, wenn ein local_time Wert in ein sys_time konvertiert wird und das Ergebnis mehrdeutig ist.
nonexistent_local_time Der Fehler wird ausgelöst, wenn ein local_time Objekt in ein sys_time konvertiert wird und das Ergebnis eine Uhrzeit ist, die nicht vorhanden ist.

Functions

Name Beschreibung
ceil(duration) Gibt das ceil Objekt duration als angegebenen Typ zurück.
ceil(time_point) Gibt das ceil Objekt time_point als angegebenen Typ zurück.
clock_cast Wandelt eine Von einer time_point Uhr in eine Entsprechung time_point für eine andere Uhr um.
duration_cast Wandelt einen duration-Objekt in einen angegebenen Typ um.
floor(duration) Gibt das floor Objekt duration als angegebenen Typ zurück.
floor(time_point) Gibt das floor Objekt time_point als angegebenen Typ zurück.
from_stream() Analysieren Sie den Eingabedatenstrom mithilfe des angegebenen Formats in einen der std::chrono Zeit- oder Intervalltypen, z day. B. , month, weekday, yearusw.
get_leap_second_info Ruft eine leap_second_info Struktur ab.
is_am Gibt an, ob ein hours Objekt AM ist.
is_pm Gibt an, ob ein hours Objekt PM ist.
locate_zone Ruft eine angegebene Zeitzone ab.
make12 Gibt ein hours 12-Stunden-Formular zurück.
make24 Gibt ein hours 24-Stunden-Formular zurück.
round(duration) Gibt ein duration Objekt zurück, das als angegebenen Typ gerundet wurde.
round(time_point) Gibt ein time_point Objekt zurück, das als angegebenen Typ gerundet wurde.
time_point_cast Wandelt einen time_point-Objekt in einen angegebenen Typ um.

Zeitzonenbezogener Bezug

Name Beschreibung
current_zone Ruft die aktuelle Zeitzone ab.
get_tzdb Ruft den ersten Zeitzonendatenbankeintrag ab.
get_tzdb_list Ruft die Liste der Zeitzonendatenbankeinträge ab.
reload_tzdb Ruft einen aktualisierten Zeitzonendatenbankeintrag ab.
remote_version Sucht nach einem aktualisierten Datenbankeintrag für Zeitzonen.

Operatoren

Name Beschreibung
operator- Subtrahieren oder Negieren verschiedener <chrono> Objekte.
operator!= Ungleichheitsoperator, der mit verschiedenen <chrono> Objekten verwendet wird.
operator modulo Operator für Modulo-Vorgänge für duration-Objekte.
operator* Multiplikationsoperator für duration-Objekte.
operator/ Divisionsoperator für duration-Objekte.
operator/ Stellt eine Syntax zum Erstellen von Kalenderdaten bereit.
operator+ Zu verschiedenen <chrono> Objekten hinzufügen.
operator< Bestimmt, ob verschiedene <chrono> Objekte kleiner als eine andere sind.
operator<= Bestimmt, ob verschiedene <chrono> Objekte kleiner oder gleich einem anderen sind.
operator== Bestimmt, ob verschiedene <chrono> Objekte gleicheinander sind.
operator> Bestimmt, ob verschiedene <chrono> Objekte größer als eine andere sind.
operator>= Bestimmt, ob verschiedene <chrono> Objekte größer oder gleich einem anderen sind.

TypeDefs

Weitere Informationen zu Verhältnistypen, die in den folgenden Typedefs verwendet werden, finden Sie unter <ratio>.

Komforttypen duration

Name Beschreibung
typedef duration<long long, nano> nanoseconds; Synonym für einen duration Typ mit einer Teilstrichperiode von einem Milliardenwert (1/1.000.000.000) einer Sekunde.
typedef duration<long long, micro> microseconds; Synonym für einen duration Typ mit einer Teilstrichperiode von einem Millionstel (1/1.000.000) einer Sekunde.
typedef duration<long long, milli> milliseconds; Synonym für einen duration Typ, der eine Teilstrichperiode von einem Tausendstel (1/1.000) einer Sekunde hat.
typedef duration<long long> seconds; Synonym für einen duration Typ mit einer Teilstrichperiode von 1 Sekunde.
typedef duration<int, ratio<60>> minutes; Synonym für einen duration Typ mit einer Teilstrichperiode von 1 Minute.
typedef duration<int, ratio<3600>> hours; Synonym für einen duration Typ, der eine Teilstrichperiode von 1 Stunde hat.

Komforttypen time_point

Name Beschreibung
file_time Ein Synonym für time_point<file_clock, Duration>. Stellt ein time_point für ein file_clock. Sie geben z. Bfile_time<seconds> ft;. die Duration.
gps_seconds Ein Synonym für gps_time<seconds>; die Anzahl von Sekunden, dargestellt durch eine, die einem time_point gps_clockzugeordnet ist.
gps_time Ein Synonym für time_point<gps_clock, Duration>. Stellt ein time_point für ein gps_clock. Sie geben z. Bgps_time<milliseconds> gps;. die Duration.
local_days Ein Synonym für local_time<days>. Eine Anzahl von Tagen, dargestellt durch eine time_point Zeitzone, die keiner Zeitzone zugeordnet ist.
local_seconds Ein Synonym für local_time<seconds>.
local_time Ein Synonym für time_point<local_t, Duration>. Stellt eine time_point für eine lokale Zeit dar, die noch keiner Zeitzone zugeordnet ist. Sie geben z. Blocal_time<seconds> lt;. die Duration. A local_time ist eine Ortszeit irgendwo. Es ist nicht die aktuelle Ortszeit der Computeruhr. Nur wenn Sie ein Paar mit einer local_time time_zone erhalten, erhalten Sie einen Punkt, der in UTC-Zeit oder die Uhrzeit in einer bestimmten Zeitzone konvertiert werden kann.
sys_days Ein Synonym für sys_time<days>. Eine Anzahl von Tagen seit der Epoche des system_clock, dargestellt durch eine time_point , die einem system_clockzugeordnet ist.
sys_seconds Ein Synonym für sys_time<seconds>. Anzahl der Nicht-Schalt sekunden seit der Epoche von system_clock (1. Januar 1970 00:00:00:00 UTC), dargestellt durch eine time_point , die einem system_clockzugeordnet ist.
sys_time Ein Synonym für time_point<system_clock, Duration>. Sie geben z. Bsys_time<seconds> st;. die Duration. Stellt einen time_point zurückgegebenen Wert dar.system_clock::now() Es stellt Unix-Zeit dar, die die UTC-Zeit genau annähert.
tai_seconds Ein Synonym für tai_time<seconds>. Eine Anzahl von Sekunden, dargestellt durch eine, die einem time_point tai_clockzugeordnet ist.
tai_time Ein Synonym für time_point<tai_clock, Duration>. Sie geben z. Btai_time<seconds> tt;. die Duration. Stellt ein time_point für ein tai_clock.
utc_seconds Ein Synonym für utc_time<seconds>;
utc_time Ein Synonym für time_point<utc_clock, Duration>. Sie geben z. Butc_time<seconds> ut;. die Duration. Stellt ein time_point für ein utc_clock.

Typeigenschaften

Name Beschreibung
clock_time_conversion Ein Merkmal, das angibt, wie eine Von einer time_point Uhr in eine andere konvertiert werden soll.
is_clock Überprüfen Sie, ob ein Typ eine Uhr ist.
treat_as_floating_point Überprüfen Sie, ob ein duration Teilstrich in einen anderen duration konvertiert werden kann, der einen anderen Teilstrich hat.

Literale

(C++11) Die <chrono> Kopfzeile definiert die folgenden benutzerdefinierten Literale , die Sie für mehr Benutzerfreundlichkeit, Typsicherheit und Wartung Ihres Codes verwenden können. Diese Literale werden im literals::chrono_literals Inlinenamespace definiert und befinden sich im Bereich, wenn std::chrono sich der Bereich befindet.

Deklaration Beschreibung
hours operator "" h(unsigned long long Val) Gibt die Stunden als Integralwert an.
duration<double, ratio<3600>> operator "" h(long double Val) Gibt die Stunden als Gleitkommawert an.
minutes (operator "" min)(unsigned long long Val) Gibt die Minuten als Integralwert an.
duration<double, ratio<60>> (operator "" min)( long double Val) Gibt die Minuten als Gleitkommawert an.
seconds operator "" s(unsigned long long Val) Gibt die Minuten als Integralwert an.
duration<double> operator "" s(long double Val) Gibt die Sekunden als Gleitkommawert an.
milliseconds operator "" ms(unsigned long long Val) Gibt die Millisekunden als Integralwert an.
duration<double, milli> operator "" ms(long double Val) Gibt die Millisekunden als Gleitkommawert an.
microseconds operator "" us(unsigned long long Val) Gibt die Mikrosekunden als Integralwert an.
duration<double, micro> operator "" us(long double Val) Gibt die Mikrosekunden als Gleitkommawert an.
nanoseconds operator "" ns(unsigned long long Val) Gibt die Nanosekunden als Integralwert an.
duration<double, nano> operator "" ns(long double Val) Gibt die Nanosekunden als Gleitkommawert an.

Die folgenden Beispiele zeigen, wie Literale verwendet <chrono> werden:

constexpr auto day = 24h;
constexpr auto week = 24h* 7;
constexpr auto my_duration_unit = 108ms;

Siehe auch

Headerdateienreferenz