SystemTimeToTzSpecificLocalTime, fonction (timezoneapi.h)

Article
03/02/2024

Convertit une heure en temps universel coordonné (UTC) en heure locale correspondante d’un fuseau horaire spécifié.

Syntaxe

BOOL SystemTimeToTzSpecificLocalTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpUniversalTime,
  [out]          LPSYSTEMTIME                lpLocalTime
);

Paramètres

[in, optional] lpTimeZoneInformation

Pointeur vers une structure de TIME_ZONE_INFORMATION qui spécifie le fuseau horaire d’intérêt.

Si lpTimeZone a la valeur NULL, la fonction utilise le fuseau horaire actif.

[in] lpUniversalTime

Pointeur vers une structure SYSTEMTIME qui spécifie l’heure UTC à convertir. La fonction convertit cette heure universelle en heure locale correspondante du fuseau horaire spécifié.

[out] lpLocalTime

Pointeur vers une structure SYSTEMTIME qui reçoit l’heure locale.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro et la fonction définit les membres de la structure SYSTEMTIME pointées par lpLocalTime sur les valeurs d’heure locales appropriées.

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

La fonction SystemTimeToTzSpecificLocalTime prend en compte si l’heure d’été (DST) est en vigueur pour l’heure locale à laquelle l’heure système doit être convertie.

La fonction SystemTimeToTzSpecificLocalTime peut calculer l’heure locale de manière incorrecte dans les conditions suivantes :

Le fuseau horaire utilise un décalage UTC différent pour l’ancienne et la nouvelle année.
L’heure UTC à convertir et l’heure locale calculée sont des années différentes.

Exemples

Pour obtenir un exemple, consultez Récupération de l’heure Last-Write.

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