GetTimeZoneInformation, fonction (timezoneapi.h)

Article
03/02/2024

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