std::time

 

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-Stil Datums- und Zeitwerkzeuge

Funktionen

Zeitmanipulation

difftime

time

clock

timespec_get (C++17)

Formatkonvertierungen

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

Konstanten

CLOCKS_PER_SEC

Typen

tm

time_t

clock_t

timespec (C++17)

 

Definiert im Header <ctime>
std::time_t time( std::time_t* arg );

Gibt die aktuelle Kalenderzeit zurück, kodiert als std::time_t-Objekt, und speichert sie auch im Objekt, auf das arg zeigt, es sei denn, arg ist ein Nullzeiger.

Parameter

arg

-

Zeiger auf ein std::time_t-Objekt, in dem die Zeit gespeichert werden soll, oder ein Nullzeiger

Rückgabewert

Aktuelle Kalenderzeit, kodiert als std::time_t-Objekt bei Erfolg, (std::time_t)(-1) bei einem Fehler. Wenn arg nicht null ist, wird der Rückgabewert auch im Objekt gespeichert, auf das arg zeigt.

Hinweise

Die Kodierung der Kalenderzeit in std::time_t ist nicht spezifiziert, aber die meisten Systeme entsprechen der POSIX-Spezifikation und geben einen Wert vom ganzzahligen Typ zurück, der 86400 Mal die Anzahl der Kalendertage seit der Epoche plus die Anzahl der Sekunden seit Mitternacht UTC (Coordinated Universal Time) enthält. Insbesondere berücksichtigt die POSIX-Zeit keine Schaltsekunden und ist daher nicht gleich der Anzahl der SI-Sekunden seit der Epoche, sondern wird um die Anzahl der seit der Epoche aufgetretenen Schaltsekunden reduziert. Implementierungen, bei denen std::time_t ein 32-Bit-Vorzeichen-Integer ist (viele historische Implementierungen), scheitern im Jahr 2038.

Beispiel

Führen Sie diesen Code aus

#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::asctime(std::localtime(&result))
              << result << " seconds since the Epoch\n";
}

Mögliche Ausgabe

Wed Sep 21 10:27:52 2011
1316615272 seconds since the Epoch

Siehe auch

timespec_get (C++17)	gibt die Kalenderzeit in Sekunden und Nanosekunden basierend auf einer gegebenen Zeitbasis zurück (Funktion)
localtime	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als lokale Zeit (Funktion)
gmtime	Konvertiert die seit der Epoche vergangene Zeit in eine Kalenderzeit, ausgedrückt als Universal Coordinated Time. (Funktion)
system_clock (C++11)	Systemuhrzeit von der systemweiten Echtzeituhr (Klasse)
C-Dokumentation für time