Funzione GetTimeZoneInformationForYear (timezoneapi.h)

Recupera le impostazioni del fuso orario per l'anno e il fuso orario specificati. Queste impostazioni controllano le traduzioni tra l'ora UTC (Coordinated Universal Time) e l'ora locale.

Sintassi

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

Parametri

[in] wYear

Anno per il quale devono essere recuperate le impostazioni del fuso orario. Il parametro wYear deve essere un valore di ora locale.

[in, optional] pdtzi

Puntatore a una struttura DYNAMIC_TIME_ZONE_INFORMATION che specifica il fuso orario. Per popolare questo parametro, chiamare EnumDynamicTimeZoneInformation con l'indice del fuso orario desiderato. Se questo parametro è NULL, viene utilizzato il fuso orario corrente.

[out] ptzi

Puntatore a una struttura TIME_ZONE_INFORMATION che riceve le impostazioni del fuso orario.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Si presuppone che il parametro wYear sia un valore di ora locale. Se l'ora locale è vicina alla transizione tra l'anno precedente e il nuovo anno (00:00:00 gennaio 1), il passaggio di un anno UTC alla funzione GetTimeZoneInformationForYear può causare la restituzione delle impostazioni del fuso orario per l'anno errato.

I membri StandardName e DaylightName della struttura TIME_ZONE_INFORMATION risultante vengono localizzati in base alla lingua dell'interfaccia utente predefinita dell'utente corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1 [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	timezoneapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

DYNAMIC_TIME_ZONE_INFORMATION

Ora locale

TIME_ZONE_INFORMATION

Funzioni temporali