GetTimeZoneInformation-Funktion (timezoneapi.h)

Artikel
03/02/2024

Ruft die aktuellen Zeitzoneneinstellungen ab. Diese Einstellungen steuern die Übersetzungen zwischen koordinierter Weltzeit (UTC) und Ortszeit.

Verwenden Sie die Funktion GetDynamicTimeZoneInformation oder GetTimeZoneInformationForYear , um Grenzen für die Sommerzeit zu unterstützen, die sich von Jahr zu Jahr ändern.

Syntax

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Parameter

[out] lpTimeZoneInformation

Ein Zeiger auf eine TIME_ZONE_INFORMATION-Struktur , um die aktuellen Einstellungen zu empfangen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
TIME_ZONE_ID_UNKNOWN 0	Die Sommerzeit wird in der aktuellen Zeitzone nicht verwendet, da es keine Übergangstermine gibt oder die automatische Anpassung der Sommerzeit deaktiviert ist.
TIME_ZONE_ID_STANDARD 1	Das System arbeitet in dem Bereich, der vom StandardDate-Element der TIME_ZONE_INFORMATION-Struktur abgedeckt wird.
TIME_ZONE_ID_DAYLIGHT 2	Das System arbeitet in dem Bereich, der vom DaylightDate-Member der TIME_ZONE_INFORMATION-Struktur abgedeckt wird.

Wenn die Funktion aus anderen Gründen fehlschlägt, z. B. aufgrund eines Fehlers mit nicht genügend Arbeitsspeicher, wird TIME_ZONE_ID_INVALID zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Alle Übersetzungen zwischen UTC-Zeit und Ortszeit basieren auf der folgenden Formel:

UTC = Ortszeit + Verzerrung

Die Abweichung ist der Unterschied in Minuten zwischen UTC-Zeit und Ortszeit.

Die Elemente StandardName und DaylightName der resultierenden TIME_ZONE_INFORMATION Struktur werden gemäß der aktuellen Benutzeroberflächenstandardsprache lokalisiert.

Beispiele

Ein Beispiel finden Sie unter SetTimeZoneInformation.

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ßen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll