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

Siehe auch

DYNAMIC_TIME_ZONE_INFORMATION

Ortszeit

TIME_ZONE_INFORMATION

Zeitfunktionen