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 |
|---|---|
|
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é. |
|
Le système fonctionne dans la plage couverte par le membre StandardDate de la structure TIME_ZONE_INFORMATION . |
|
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 |