SystemTimeToTzSpecificLocalTime-Funktion (timezoneapi.h)
Konvertiert eine Zeit in koordinierter Weltzeit (UTC) in die entsprechende Ortszeit einer angegebenen Zeitzone.
Syntax
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
Parameter
[in, optional] lpTimeZoneInformation
Ein Zeiger auf eine TIME_ZONE_INFORMATION-Struktur , die die zeitzonen von Interesse angibt.
Wenn lpTimeZoneNULL ist, verwendet die Funktion die aktuell aktive Zeitzone.
[in] lpUniversalTime
Ein Zeiger auf eine SYSTEMTIME-Struktur , die die zu konvertierende UTC-Zeit angibt. Die Funktion konvertiert diese universelle Zeit in die entsprechende Ortszeit der angegebenen Zeitzone.
[out] lpLocalTime
Ein Zeiger auf eine SYSTEMTIME-Struktur , die die Ortszeit empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero, und die Funktion legt die Member der SYSTEMTIME-Struktur , auf die von lpLocalTime verwiesen wird, auf die entsprechenden lokalen Zeitwerte fest.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die SystemTimeToTzSpecificLocalTime-Funktion berücksichtigt, ob die Sommerzeit (Sommerzeit, DST) für die Lokale Zeit gilt, in die die Systemzeit konvertiert werden soll.
Die SystemTimeToTzSpecificLocalTime-Funktion kann die Lokale Zeit unter den folgenden Bedingungen falsch berechnen:
- Die Zeitzone verwendet einen anderen UTC-Offset für das alte und das neue Jahr.
- Die zu konvertierende UTC-Zeit und die berechnete Ortszeit liegen in unterschiedlichen Jahren vor.
Beispiele
Ein Beispiel finden Sie unter Abrufen der Last-Write Zeit.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | timezoneapi.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |