Condividi tramite


Funzione GetTimeZoneInformation (timezoneapi.h)

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

Vedere anche

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Ora locale

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Funzioni temporali