Freigeben über


Uhrzeitverwaltung

Verwenden Sie diese Funktionen, um die aktuelle Uhrzeit abzurufen und sie nach Bedarf zu konvertieren, anzupassen und zu speichern. Die aktuelle Uhrzeit ist die Systemzeit.

Die _ftime - und localtime -Routinen verwenden die TZ -Umgebungsvariable. Falls TZ nicht festgelegt, versucht die Laufzeitbibliothek, die vom Betriebssystem angegebenen Zeitzoneninformationen zu verwenden. Stehen diese Informationen nicht zur Verfügung, verwenden diese Funktionen den Standardwert von PST8PDT. Weitere Informationen zu , siehe _tzset; auch unter_daylight , , timezoneund _tzname.TZ

Zeitroutinen

Funktion Verwendung
asctime, _wasctime, asctime_s, _wasctime_s Konvertiert einen Zeitwert vom Typ struct tm in eine Zeichenfolge. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
clock Gibt die verstrichene Wanduhrzeit für den Prozess zurück.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s Konvertiert einen Zeitwert vom Typ time_t, __time32_t oder __time64_t in eine Zeichenfolge. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
difftime, _difftime32, _difftime64 Bestimmt den Unterschied zwischen zwei Uhrzeiten.
_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_s Speichert die aktuelle Systemzeit in einer Variablen vom Typ struct _timeb oder struct __timeb64 Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
_futime, _futime32, _futime64 Legt die Änderungszeit einer offenen Datei fest.
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s Konvertieren von Zeit vom Typ time_t in struct tm oder vom Typ __time64_t in struct tm. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s Konvertieren eines Zeitwerts vom Typ time_t in struct tm oder vom Typ __time64_t in struct tm mit lokaler Korrektur. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
_mkgmtime, _mkgmtime32, _mkgmtime64 Konvertiert einen Zeitwert in einen Kalenderwert in GMT (Greenwich Mean Time).
mktime, _mktime32, _mktime64 Konvertiert einen Zeitwert in einen Kalenderwert.
_strdate, _wstrdate, _strdate_s, _wstrdate_s Gibt das aktuelle Systemdatum als Zeichenfolge zurück. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
strftime, wcsftime, _strftime_l, _wcsftime_l Formatiert die Datums- und Uhrzeitzeichenfolge für die internationale Verwendung.
_strtime, _wstrtime, _strtime_s, _wstrtime_s Gibt die aktuelle Systemzeit als Zeichenfolge zurück. Die Versionen dieser Funktionen mit dem Suffix _s sind sicherer.
time, _time32, _time64 Ruft die aktuelle Systemzeit als Typ time_t, __time32_t oder als Typ __time64_tab.
_tzset Legt externe Zeitvariablen aus Umgebungsvariable TZfest.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64 Legt die Änderungszeit für eine angegebene Datei fest. Hierzu wird entweder die aktuelle Uhrzeit oder der Uhrzeitwert verwendet, der in der Struktur gespeichert ist.

Hinweis

Die Uhrzeitfunktion gibt in allen Versionen von Microsoft C/C++ (mit Ausnahme von Microsoft C/C++ 7.0) und in allen Versionen von Visual C++ die aktuelle Uhrzeit als die Anzahl von Sekunden zurück, die seit dem 1. Januar 1970 verstrichen sind. In Microsoft C/C++ 7.0 gab time die aktuelle Uhrzeit als die Anzahl von Sekunden zurück, die seit dem 31. Dezember 1899 verstrichen sind.

Hinweis

In Versionen von Visual C++ und Microsoft C/C++ vor Visual Studio 2005 time_t war eine long int (32 Bit) und daher konnten sie nicht für Datumsangaben verwendet werden, die am 19. Januar 2038, UTC, 3:14:07. Januar 2038 liegen. time_t entspricht jetzt standardmäßig __time64_t , aber das Definieren von _USE_32BIT_TIME_T ändert time_t in __time32_t und zwingt viele Zeitfunktionen zum Aufruf von Versionen, die die 32-Bit-Version von time_takzeptieren. Weitere Informationen finden Sie unter Standardtypen und Kommentare in der Dokumentation für die einzelnen Zeitfunktionen.

Siehe auch

Universelle C-Laufzeitroutinen nach Kategorie