Datums- und Zeitbibliothek

 

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

 

C++ unterstützt zwei Arten der Zeitmanipulation

• Die chrono Bibliothek, eine flexible Sammlung von Typen, die Zeit mit unterschiedlichen Präzisionen verfolgen (z.B. std::chrono::time_point).
• Die C-Stil Datums- und Zeitbibliothek (z.B. std::time).

Chrono Bibliothek (seit C++11)

Die chrono Bibliothek definiert mehrere Haupttypen sowie Hilfsfunktionen und gängige Typedefs

• Uhren
• Zeitpunkte
• Dauern

Kalenderdaten Zeitzoneninformationen

(seit C++20)

Uhren

Eine Uhr besteht aus einem Startpunkt (oder Epoche) und einer Taktfrequenz. Zum Beispiel kann eine Uhr eine Epoche am 1. Januar 1970 haben und jede Sekunde ticken. C++ definiert mehrere Uhrentypen

Definiert in Header <chrono>
Definiert im Namespace std::chrono
system_clock (C++11)	Systemuhrzeit von der systemweiten Echtzeituhr (Klasse)
steady_clock (C++11)	monotone Uhr, die niemals verstellt wird (Klasse)
high_resolution_clock (C++11)	die Uhr mit der kürzesten verfügbaren Taktperiode (Klasse)
is_clockis_clock_v (C++20)	bestimmt, ob ein Typ eine Clock ist (Klassen-Template) (Variablen-Template)
utc_clock (C++20)	Clock für koordinierte Weltzeit (UTC) (Klasse)
tai_clock (C++20)	Clock für Internationale Atomzeit (TAI) (Klasse)
gps_clock (C++20)	Clock für GPS-Zeit (Klasse)
file_clock (C++20)	Clock für Dateizeit (Typedef)
local_t (C++20)	Pseudo-Uhr, die die Lokalzeit repräsentiert (Klasse)

Zeitpunkt

Ein Zeitpunkt ist eine Zeitdauer, die seit der Epoche einer bestimmten Uhr vergangen ist.

Definiert in Header <chrono>
Definiert im Namespace std::chrono
time_point (C++11)	Ein Zeitpunkt (Klassen-Template)
clock_time_conversion (C++20)	Traits-Klasse, die definiert, wie Zeitpunkte einer Uhr in andere umgewandelt werden (Klassen-Template)
clock_cast (C++20)	wandelt Zeitpunkte einer Uhr in andere um (Funktions-Template)

Dauer

Eine Dauer besteht aus einer Zeitspanne, definiert als eine bestimmte Anzahl von Ticks einer bestimmten Zeiteinheit. Zum Beispiel könnte "42 Sekunden" durch eine Dauer dargestellt werden, die aus 42 Ticks einer 1-Sekunden-Zeiteinheit besteht.

Definiert in Header <chrono>
Definiert im Namespace std::chrono
duration (C++11)	Ein Zeitintervall (Klassen-Template)

Tageszeit (seit C++20)

hh_mm_ss teilt eine Dauer, die seit Mitternacht vergangene Zeit repräsentiert, in Stunden, Minuten, Sekunden und Bruchteile von Sekunden auf, je nach Anwendbarkeit. Sie ist primär ein Formatierungswerkzeug.

Definiert in Header <chrono>
Definiert im Namespace std::chrono
hh_mm_ss (C++20)	repräsentiert eine Tageszeit (Klassen-Template)
is_amis_pmmake12make24 (C++20)	übersetzt zwischen 12h/24h-Format Tageszeiten (Funktion)

Kalender (seit C++20)

Definiert in Header <chrono>
Definiert im Namespace std::chrono
last_spec (C++20)	Tag-Klasse, die den letzten Tag oder Wochentag eines Monats angibt (Klasse)
day (C++20)	repräsentiert einen Tag eines Monats (Klasse)
month (C++20)	repräsentiert einen Monat eines Jahres (Klasse)
year (C++20)	repräsentiert ein Jahr im Gregorianischen Kalender (Klasse)
weekday (C++20)	repräsentiert einen Wochentag im Gregorianischen Kalender (Klasse)
weekday_indexed (C++20)	repräsentiert den n-ten weekday eines Monats (Klasse)
weekday_last (C++20)	repräsentiert den letzten weekday eines Monats (Klasse)
month_day (C++20)	repräsentiert einen bestimmten day eines bestimmten month (Klasse)
month_day_last (C++20)	repräsentiert den letzten Tag eines bestimmten month (Klasse)
month_weekday (C++20)	repräsentiert den n-ten weekday eines bestimmten month (Klasse)
month_weekday_last (C++20)	repräsentiert den letzten weekday eines bestimmten month (Klasse)
year_month (C++20)	repräsentiert einen bestimmten month eines bestimmten year (Klasse)
year_month_day (C++20)	repräsentiert ein bestimmtes year, month und day (Klasse)
year_month_day_last (C++20)	repräsentiert den letzten Tag eines bestimmten year und month (Klasse)
year_month_weekday (C++20)	repräsentiert den n-ten weekday eines bestimmten year und month (Klasse)
year_month_weekday_last (C++20)	repräsentiert den letzten weekday eines bestimmten year und month (Klasse)
operator/ (C++20)	konventionelle Syntax für die Erstellung von Kalenderdaten im Gregorianischen Kalender (Funktion)

Zeitzone (seit C++20)

Definiert in Header <chrono>
Definiert im Namespace std::chrono
tzdb (C++20)	beschreibt eine Kopie der IANA-Zeitzonendatenbank (Klasse)
tzdb_list (C++20)	repräsentiert eine verkettete Liste von tzdb (Klasse)
get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)	greift auf globale Zeitzonendatenbankinformationen zu und steuert diese (Funktion)
locate_zone (C++20)	lokalisiert eine time_zone anhand ihres Namens (Funktion)
current_zone (C++20)	gibt die aktuelle time_zone zurück (Funktion)
time_zone (C++20)	repräsentiert eine Zeitzone (Klasse)
sys_info (C++20)	repräsentiert Informationen über eine Zeitzone zu einem bestimmten Zeitpunkt (Klasse)
local_info (C++20)	repräsentiert Informationen über eine Umwandlung von Lokalzeit zu UNIX-Zeit (Klasse)
choose (C++20)	wählt aus, wie eine mehrdeutige Lokalzeit aufgelöst werden soll (Enum)
zoned_traits (C++20)	Traits-Klasse für Zeitzonenzeiger, die von zoned_time verwendet werden (Klassen-Template)
zoned_time (C++20)	repräsentiert eine Zeitzone und einen Zeitpunkt (Klasse)
leap_second (C++20)	enthält Informationen über eine Schaltsekundeneinfügung (Klasse)
leap_second_info (C++20)	Informationen zur Schaltsekundeneinfügung (Klasse)
get_leap_second_info (C++20)	erhält Informationen zur Schaltsekundeneinfügung aus einem utc_time-Objekt (Funktions-Template)
time_zone_link (C++20)	repräsentiert einen alternativen Namen für eine Zeitzone (Klasse)
nonexistent_local_time (C++20)	Ausnahme, die geworfen wird, um zu melden, dass eine Lokalzeit nicht existiert (Klasse)
ambiguous_local_time (C++20)	Ausnahme, die geworfen wird, um zu melden, dass eine Lokalzeit mehrdeutig ist (Klasse)

Literale (seit C++14)

Definiert in Header <chrono>
Definiert im Inline-Namespace std::literals::chrono_literals
operator""y (C++20)	ein std::chrono::year Literal, das ein bestimmtes Jahr repräsentiert (Funktion)
operator""d (C++20)	ein std::chrono::day Literal, das einen Tag eines Monats repräsentiert (Funktion)
operator""h (C++14)	ein std::chrono::duration Literal, das Stunden repräsentiert (Funktion)
operator""min (C++14)	ein std::chrono::duration Literal, das Minuten repräsentiert (Funktion)
operator""s (C++14)	ein std::chrono::duration Literal, das Sekunden repräsentiert (Funktion)
operator""ms (C++14)	ein std::chrono::duration Literal, das Millisekunden repräsentiert (Funktion)
operator""us (C++14)	ein std::chrono::duration Literal, das Mikrosekunden repräsentiert (Funktion)
operator""ns (C++14)	ein std::chrono::duration Literal, das Nanosekunden repräsentiert (Funktion)

Chrono E/A (seit C++20)

Definiert in Header <chrono>
Definiert im Namespace std::chrono
parse (C++20)	parst ein chrono Objekt aus einem Stream (Funktions-Template)

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_chrono	201510L	(C++17)	Rundungsfunktionen für std::chrono::duration und std::chrono::time_point
	201611L	(C++17)	constexpr für alle Memberfunktionen von std::chrono::duration und std::chrono::time_point
	201907L	(C++20)	Kalender und Zeitzonen
	202306L	(C++26)	Unterstützung für Hashing für std::chrono Wertklassen

C-Stil Datums- und Zeitbibliothek

Ebenso werden C-Stil Datums- und Zeitfunktionen bereitgestellt, wie z.B. std::time_t, std::difftime und CLOCKS_PER_SEC.

Beispiel

Führen Sie diesen Code aus

#include <chrono>
#include <iostream>
 
long Fibonacci(unsigned n)
{
    return n < 2 ? n : Fibonacci(n - 1) + Fibonacci(n - 2);
}
 
int main()
{
    // Measures and displays an execution time of a function call.
    const auto start{std::chrono::steady_clock::now()};
    const auto fb{Fibonacci(42)};
    const auto finish{std::chrono::steady_clock::now()};
    const std::chrono::duration<double> elapsed_seconds{finish - start};
 
    std::cout << "Fibonacci(42): " << fb << "\nElapsed time: ";
//  std::cout << elapsed_seconds.count() << "s\n"; // Before C++20
    std::cout << elapsed_seconds << '\n'; // C++20's chrono::duration operator<<
 
    // Prints UTC and local time.
    const auto tp_utc{std::chrono::system_clock::now()};
    std::cout << "Current time 'UTC' is: " << tp_utc << "\n"
                 "Current time 'Local' is: "
              << std::chrono::current_zone()->to_local(tp_utc) << '\n';
}

Mögliche Ausgabe

Fibonacci(42): 267914296
Elapsed time: 0.728532s
Current time 'UTC' is: 2025-02-10 06:22:39.420666960
Current time 'Local' is: 2025-02-10 09:22:39.420666960