GetTimeZoneInformationForYear, fonction (timezoneapi.h)

Récupère les paramètres de fuseau horaire pour l’année et le fuseau horaire spécifiés. Ces paramètres contrôlent les traductions entre le temps universel coordonné (UTC) et l’heure locale.

Syntaxe

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

Paramètres

[in] wYear

Année pour laquelle les paramètres de fuseau horaire doivent être récupérés. Le paramètre wYear doit être une valeur d’heure locale.

[in, optional] pdtzi

Pointeur vers une structure DYNAMIC_TIME_ZONE_INFORMATION qui spécifie le fuseau horaire. Pour remplir ce paramètre, appelez EnumDynamicTimeZoneInformation avec l’index du fuseau horaire souhaité. Si ce paramètre a la valeur NULL, le fuseau horaire actuel est utilisé.

[out] ptzi

Pointeur vers une structure de TIME_ZONE_INFORMATION qui reçoit les paramètres de fuseau horaire.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le paramètre wYear est supposé être une valeur d’heure locale. Si l’heure locale est proche de la transition entre l’ancienne année et la nouvelle année (00 :00 :00 le 1er janvier), le passage d’une année UTC à la fonction GetTimeZoneInformationForYear peut entraîner le renvoi des paramètres de fuseau horaire pour l’année incorrecte.

Les membres StandardName et DaylightName de la structure TIME_ZONE_INFORMATION résultante sont localisés en fonction de la langue d’interface utilisateur par défaut de l’utilisateur actuel.

Configuration requise

Voir aussi

DYNAMIC_TIME_ZONE_INFORMATION

Heure locale

TIME_ZONE_INFORMATION

Fonctions de temps