GetTimeZoneInformationForYear-Funktion (timezoneapi.h)
Ruft die Zeitzoneneinstellungen für das angegebene Jahr und die angegebene Zeitzone ab. Diese Einstellungen steuern die Übersetzungen zwischen koordinierter Weltzeit (UTC) und Ortszeit.
Syntax
BOOL GetTimeZoneInformationForYear(
[in] USHORT wYear,
[in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
[out] LPTIME_ZONE_INFORMATION ptzi
);
Parameter
[in] wYear
Das Jahr, für das die Zeitzoneneinstellungen abgerufen werden sollen. Der wYear-Parameter muss ein lokaler Zeitwert sein.
[in, optional] pdtzi
Ein Zeiger auf eine DYNAMIC_TIME_ZONE_INFORMATION-Struktur , die die Zeitzone angibt. Um diesen Parameter aufzufüllen, rufen Sie EnumDynamicTimeZoneInformation mit dem Index der gewünschten Zeitzone auf. Wenn dieser Parameter NULL ist, wird die aktuelle Zeitzone verwendet.
[out] ptzi
Ein Zeiger auf eine TIME_ZONE_INFORMATION Struktur, die die Zeitzoneneinstellungen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Der wYear-Parameter wird als lokaler Zeitwert angenommen. Wenn die Lokale Zeit nahe dem Übergang zwischen dem alten Jahr und dem neuen Jahr (00:00:00: 00 Januar 1) liegt, kann das Übergeben eines UTC-Jahres an die GetTimeZoneInformationForYear-Funktion dazu führen, dass die Funktion Zeitzoneneinstellungen für das falsche Jahr zurückgibt.
Die Elemente StandardName und DaylightName der resultierenden TIME_ZONE_INFORMATION Struktur werden gemäß der aktuellen Benutzerstandardsprache der Benutzeroberflächen lokalisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista mit SP1 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | timezoneapi.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |