TIME_ZONE_INFORMATION struttura (timezoneapi.h)

Specifica le impostazioni per un fuso orario.

Sintassi

typedef struct _TIME_ZONE_INFORMATION {
  LONG       Bias;
  WCHAR      StandardName[32];
  SYSTEMTIME StandardDate;
  LONG       StandardBias;
  WCHAR      DaylightName[32];
  SYSTEMTIME DaylightDate;
  LONG       DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;

Members

Bias

La deviazione corrente, espressa in minuti, per la conversione dell'ora locale in questo computer. Il pregiudizio è la differenza, in minuti, tra l'ora UTC (Coordinated Universal Time) e l'ora locale. Tutte le traduzioni tra UTC e ora locale si basano sulla formula seguente:

UTC = ora locale e pregiudizi

Questo membro è obbligatorio.

StandardName[32]

Descrizione per l'ora standard. Ad esempio, "EST" potrebbe indicare l'ora standard orientale. La stringa verrà restituita invariata dalla funzione GetTimeZoneInformation . Questa stringa può essere vuota.

StandardDate

Struttura SYSTEMTIME che contiene una data e un'ora locale quando si verifica la transizione dall'ora legale all'ora legale in questo sistema operativo. Se il fuso orario non supporta l'ora legale o se il chiamante deve disabilitare l'ora legale, il membro wMonth nella struttura SYSTEMTIME deve essere zero. Se questa data è specificata, è necessario specificare anche il membro DaylightDate di questa struttura.

In caso contrario, il sistema presuppone che i dati del fuso orario non siano validi e non verranno applicate modifiche.

Per selezionare il giorno corretto nel mese, impostare il membro wYear su zero, i membri wHour e wMinute all'ora di transizione, il membro wDayOfWeek al giorno del giorno lavorativo appropriato e il membro wDay per indicare l'occorrenza del giorno della settimana entro il mese (da 1 a 5, dove 5 indica l'occorrenza finale durante il mese se tale giorno della settimana non si verifica 5 volte).

Usando questa notazione, specificare 02:00 la prima domenica di aprile come indicato di seguito: wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Specificare 02:00 nell'ultimo giovedì di ottobre come indicato di seguito: wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.

Se il membro wYear non è zero, la data di transizione è assoluta; si verificherà una sola volta. In caso contrario, si tratta di una data relativa che si verifica annualmente.

StandardBias

Valore di pregiudizio da usare durante le traduzioni dell'ora locale che si verificano durante l'ora standard. Questo membro viene ignorato se non viene fornito un valore per il membro StandardDate .

Questo valore viene aggiunto al valore del membro Bias per formare la distorsione usata durante l'ora standard. Nella maggior parte dei fusi orari il valore di questo membro è zero.

DaylightName[32]

Descrizione dell'ora legale. Ad esempio, "PDT" potrebbe indicare l'ora legale del Pacifico. La stringa verrà restituita invariata dalla funzione GetTimeZoneInformation . Questa stringa può essere vuota.

DaylightDate

Struttura SYSTEMTIME che contiene una data e un'ora locale in cui si verifica la transizione dall'ora solare all'ora legale in questo sistema operativo. Se il fuso orario non supporta l'ora legale o se il chiamante deve disabilitare l'ora legale, il membro wMonth nella struttura SYSTEMTIME deve essere zero. Se questa data è specificata, è necessario specificare anche il membro StandardDate in questa struttura.

In caso contrario, il sistema presuppone che i dati del fuso orario non siano validi e non verranno applicate modifiche.

Per selezionare il giorno corretto nel mese, impostare il membro wYear su zero, i membri wHour e wMinute all'ora di transizione, il membro wDayOfWeek al giorno del giorno lavorativo appropriato e il membro wDay per indicare l'occorrenza del giorno della settimana entro il mese (da 1 a 5, dove 5 indica l'occorrenza finale durante il mese se tale giorno della settimana non si verifica 5 volte).

Se il membro wYear non è zero, la data di transizione è assoluta; si verificherà una sola volta. In caso contrario, si tratta di una data relativa che si verifica annualmente.

DaylightBias

Valore di pregiudizio da usare durante le traduzioni dell'ora locale che si verificano durante l'ora legale. Questo membro viene ignorato se non viene fornito un valore per il membro DaylightDate .

Questo valore viene aggiunto al valore del membro Bias per formare la distorsione utilizzata durante l'ora legale. Nella maggior parte dei fusi orari il valore di questo membro è –60.

Commenti

Le impostazioni per ogni fuso orario vengono archiviate nella chiave del Registro di sistema seguente:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

Ogni voce del fuso orario include i valori del Registro di sistema seguenti.

typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;

Per altre informazioni sulla chiave DST dinamica , vedere DYNAMIC_TIME_ZONE_INFORMATION.

Sia StandardName che DaylightName vengono localizzati in base alla lingua dell'interfaccia utente predefinita dell'utente corrente.

Esempio

Per un esempio, vedere SetTimeZoneInformation.

Requisiti

Vedi anche

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation