SystemTimeToTzSpecificLocalTime-Funktion (timezoneapi.h)

Artikel
03/02/2024

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