structure TIME_ZONE_INFORMATION (timezoneapi.h)
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.
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).
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.
|
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) |