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 |
|---|---|
|
Die Sommerzeit wird in der aktuellen Zeitzone nicht verwendet, da es keine Übergangstermine gibt oder die automatische Anpassung der Sommerzeit deaktiviert ist. |
|
Das System arbeitet in dem Bereich, der vom StandardDate-Element der TIME_ZONE_INFORMATION-Struktur abgedeckt wird. |
|
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 |