Freigeben über


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

Siehe auch

GetSystemTime

GetTimeZoneInformation

SYSTEMTIME

Systemzeit

TIME_ZONE_INFORMATION

Zeitfunktionen

TzSpecificLocalTimeToSystemTime