Partager via


GetTimeZoneInformation, fonction (timezoneapi.h)

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

Pour prendre en charge les limites de l’heure d’été qui changent d’une année à l’autre, utilisez la fonction GetDynamicTimeZoneInformation ou GetTimeZoneInformationForYear .

Syntaxe

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Paramètres

[out] lpTimeZoneInformation

Pointeur vers une structure TIME_ZONE_INFORMATION pour recevoir les paramètres actuels.

Valeur retournée

Si la fonction réussit, elle retourne l’une des valeurs suivantes.

Code/valeur de retour Description
TIME_ZONE_ID_UNKNOWN
0
L’heure d’été n’est pas utilisée dans le fuseau horaire actuel, car il n’y a aucune date de transition ou l’ajustement automatique pour l’heure d’été est désactivé.
TIME_ZONE_ID_STANDARD
1
Le système fonctionne dans la plage couverte par le membre StandardDate de la structure TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT
2
Le système fonctionne dans la plage couverte par le membre DaylightDate de la structure TIME_ZONE_INFORMATION .
 

Si la fonction échoue pour d’autres raisons, telles qu’une erreur de mémoire insuffisante, elle retourne TIME_ZONE_ID_INVALID. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Toutes les traductions entre l’heure UTC et l’heure locale sont basées sur la formule suivante :

UTC = heure locale + biais

Le biais est la différence, en minutes, entre l’heure UTC et l’heure locale.

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.

Exemples

Pour obtenir un exemple, consultez SetTimeZoneInformation.

Configuration requise

Condition requise Valeur
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]
Plateforme cible Windows
En-tête timezoneapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Heure locale

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Fonctions de temps