Freigeben über


GetTimeZoneInformation-Funktion (timezoneapi.h)

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

Siehe auch

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Ortszeit

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Zeitfunktionen