Fonction TzSpecificLocalTimeToSystemTime (timezoneapi.h)

Article
03/09/2024

Convertit une heure locale en heure en temps universel coordonné (UTC).

Syntaxe

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

Paramètres

[in, optional] lpTimeZoneInformation

Pointeur vers une structure de TIME_ZONE_INFORMATION qui spécifie le fuseau horaire pour l’heure spécifiée dans lpLocalTime.

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

[in] lpLocalTime

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

[out] lpUniversalTime

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

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és par lpUniversalTime sur les valeurs 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

TzSpecificLocalTimeToSystemTime prend en compte si l’heure d’été (DST) est en vigueur pour l’heure locale à convertir.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	timezoneapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll