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 |