GetTimeZoneInformation-Funktion (Timezoneapi.h)
Ruft die aktuellen Zeitzoneneinstellungen ab. Diese Einstellungen steuern die Übersetzungen zwischen koordinierter Universeller Zeit (UTC) und lokaler Uhrzeit.
Um Grenzen für die Sommerzeit zu unterstützen, die sich von Jahr zu Jahr ändern, verwenden Sie die GetDynamicTimeZoneInformation - oder GetTimeZoneInformationForYear-Funktion .
Syntax
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
Parameter
[out] lpTimeZoneInformation
Ein Zeiger auf eine TIME_ZONE_INFORMATION Struktur zum Empfangen der aktuellen Einstellungen.
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 keine Übergangstermine oder automatische Anpassung für die Sommerzeit deaktiviert sind. |
|
Das System wird im Bereich ausgeführt, der von dem StandardDate-Mitglied der TIME_ZONE_INFORMATION-Struktur abgedeckt wird. |
|
Das System wird im Bereich ausgeführt, der vom DaylightDate-Element der TIME_ZONE_INFORMATION-Struktur abgedeckt wird. |
Wenn die Funktion aus anderen Gründen fehlschlägt, z. B. ein Speicherfehler, wird TIME_ZONE_ID_INVALID zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Alle Übersetzungen zwischen UTC-Zeit und lokaler Uhrzeit basieren auf der folgenden Formel:
UTC = lokale Uhrzeit + Verzerrung
Die Verzerrung ist der Unterschied zwischen UTC-Uhrzeit und lokaler Uhrzeit.
Die Elemente "StandardName " und "DaylightName " der resultierenden TIME_ZONE_INFORMATION Struktur werden entsprechend der aktuellen Benutzeroberflächeneinstellungssprache lokalisiert.
Beispiele
Ein Beispiel finden Sie unter SetTimeZoneInformation.
Anforderungen
| 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 (enthalten Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |