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
, , timezone
und _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_t ab. |
_tzset |
Legt externe Zeitvariablen aus Umgebungsvariable TZ fest. |
_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_t
akzeptieren. Weitere Informationen finden Sie unter Standardtypen und Kommentare in der Dokumentation für die einzelnen Zeitfunktionen.
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für