structure TIME_ZONE_INFORMATION (timezoneapi.h)

Article
08/26/2023

Spécifie les paramètres d’un fuseau horaire.

Syntaxe

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;

Membres

Bias

Le décalage actuel pour la traduction d'heure locale sur cet ordinateur, en minutes. Le biais est la différence, en minutes, entre le temps universel coordonné (UTC) et l’heure locale. Toutes les traductions entre l’heure UTC et l’heure locale sont basées sur la formule suivante :

UTC = heure locale + biais

Ce membre est obligatoire.

StandardName[32]

Description de l’heure standard. Par exemple, « EST » peut indiquer l’heure standard de l’Est. La chaîne sera retournée inchangée par la fonction GetTimeZoneInformation . Cette chaîne peut être vide.

StandardDate

Structure SYSTEMTIME qui contient une date et une heure locale lorsque la transition de l’heure d’été à l’heure standard se produit sur ce système d’exploitation. Si le fuseau horaire ne prend pas en charge l’heure d’été ou si l’appelant doit désactiver l’heure d’été, le membre wMonth dans la structure SYSTEMTIME doit être égal à zéro. Si cette date est spécifiée, le membre DaylightDate de cette structure doit également être spécifié.

Sinon, le système suppose que les données de fuseau horaire ne sont pas valides et qu’aucune modification n’est appliquée.

Pour sélectionner le jour correct du mois, définissez le membre wYear sur zéro, les membres wHour et wMinute sur l’heure de transition, le membre wDayOfWeek sur le jour de la semaine approprié et le membre wDay pour indiquer l’occurrence du jour de la semaine dans le mois (1 à 5, où 5 indique l’occurrence finale pendant le mois si ce jour de la semaine ne se produit pas 5 fois).

À l’aide de cette notation, spécifiez 02:00 le premier dimanche d’avril comme suit : wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Spécifiez 02:00 le dernier jeudi d’octobre comme suit : wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.

Si le membre wYear n’est pas égal à zéro, la date de transition est absolue ; elle ne se produira qu’une seule fois. Sinon, il s’agit d’une date relative qui se produit annuellement.

StandardBias

Valeur de biais à utiliser pendant les traductions d’heure locale qui se produisent pendant l’heure standard. Ce membre est ignoré si une valeur pour le membre StandardDate n’est pas fournie.

Cette valeur est ajoutée à la valeur du membre Bias pour former le biais utilisé pendant l’heure standard. Dans la plupart des fuseaux horaires, la valeur de ce membre est zéro.

DaylightName[32]

Description de l’heure d’été. Par exemple, « PDT » peut indiquer l’heure d’été du Pacifique. La chaîne sera retournée inchangée par la fonction GetTimeZoneInformation . Cette chaîne peut être vide.

DaylightDate

Structure SYSTEMTIME qui contient une date et une heure locale lorsque la transition de l’heure standard à l’heure d’été se produit sur ce système d’exploitation. Si le fuseau horaire ne prend pas en charge l’heure d’été ou si l’appelant doit désactiver l’heure d’été, le membre wMonth dans la structure SYSTEMTIME doit être égal à zéro. Si cette date est spécifiée, le membre StandardDate de cette structure doit également être spécifié.

Sinon, le système suppose que les données de fuseau horaire ne sont pas valides et qu’aucune modification n’est appliquée.

Si le membre wYear n’est pas égal à zéro, la date de transition est absolue ; elle ne se produira qu’une seule fois. Sinon, il s’agit d’une date relative qui se produit annuellement.

DaylightBias

Valeur de biais à utiliser lors des traductions d’heure locale qui se produisent à l’heure d’été. Ce membre est ignoré si une valeur pour le membre DaylightDate n’est pas fournie.

Cette valeur est ajoutée à la valeur du membre Bias pour former le biais utilisé à l’heure d’été. Dans la plupart des fuseaux horaires, la valeur de ce membre est -60.

Remarques

Les paramètres de chaque fuseau horaire sont stockés dans la clé de Registre suivante :

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

Chaque entrée de fuseau horaire inclut les valeurs de Registre suivantes.

Valeur de Registre	Type	Description
Affichage	REG_SZ	Le nom d’affichage.
Dlt	REG_SZ	Description de l’heure d’été.
MUI_Display	REG_SZ	Nom d’affichage sous forme de chaîne de la forme @path,-stringID[;commentaire]. Pour plus d’informations, consultez MUI.
MUI_Dlt	REG_SZ	Description de l’heure d’été sous forme de chaîne de la forme @path,-stringID[;commentaire].
MUI_Std	REG_SZ	Description de l’heure standard sous forme de chaîne de la forme @path,-stringID[;commentaire].
Std	REG_SZ	Description de l’heure standard.
TZI	REG_BINARY	Informations de fuseau horaire suivantes. `typedef struct _REG_TZI_FORMAT { LONG Bias; LONG StandardBias; LONG DaylightBias; SYSTEMTIME StandardDate; SYSTEMTIME DaylightDate; } REG_TZI_FORMAT;`

Pour plus d’informations sur la clé DST dynamique , consultez DYNAMIC_TIME_ZONE_INFORMATION.

StandardName et DaylightName sont localisés en fonction de la langue d’interface utilisateur par défaut de l’utilisateur actuel.

Exemples

Pour obtenir un exemple, consultez SetTimeZoneInformation.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
En-tête	timezoneapi.h (inclure Windows.h)

Voir aussi

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation