Funzione GetTimeZoneInformation (timezoneapi.h)

Articolo
03/02/2024

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

Per supportare i limiti per l'ora legale che cambiano da anno a anno, usare la funzione GetDynamicTimeZoneInformation o GetTimeZoneInformationForYear .

Sintassi

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Parametri

[out] lpTimeZoneInformation

Puntatore a una struttura TIME_ZONE_INFORMATION per ricevere le impostazioni correnti.

Valore restituito

Se la funzione ha esito positivo, restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
TIME_ZONE_ID_UNKNOWN 0	L'ora legale non viene utilizzata nel fuso orario corrente, perché non sono presenti date di transizione o regolazione automatica per l'ora legale disabilitata.
TIME_ZONE_ID_STANDARD 1	Il sistema opera nell'intervallo coperto dal membro StandardDate della struttura TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT 2	Il sistema opera nell'intervallo coperto dal membro DaylightDate della struttura TIME_ZONE_INFORMATION .

Se la funzione ha esito negativo per altri motivi, ad esempio un errore di memoria insufficiente, restituisce TIME_ZONE_ID_INVALID. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Tutte le traduzioni tra l'ora UTC e l'ora locale si basano sulla formula seguente:

UTC = ora locale + distorsione

La distorsione è la differenza, espressa in minuti, tra l'ora UTC e l'ora locale.

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

Esempio

Per un esempio, vedi SetTimeZoneInformation.

Requisiti

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