Zeitverwaltung
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 | Zweck |
|---|---|
asctime, , _wasctimeasctime_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, _wctime64_wctime32, _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.