Partager via

TzSpecificLocalTimeToSystemTimeEx, fonction (timezoneapi.h)

Convertit l’heure locale spécifiée, avec les paramètres d’heure d’été dynamique (DST), en heure d’été correspondante en temps universel coordonné (UTC).

Syntaxe

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

Paramètres

[in, optional] lpTimeZoneInformation

Pointeur vers une structure DYNAMIC_TIME_ZONE_INFORMATION qui spécifie le fuseau horaire et les paramètres DST dynamiques.

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 fois 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ée par lpUniversalTime aux valeurs appropriées.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

TzSpecificLocalTimeToSystemTimeEx prend en compte si DST est en vigueur pour la conversion de l’heure locale.

Important

Les heures locales suivantes, près des transitions DST, peuvent être ambiguës ou non valides et peuvent entraîner un comportement inattendu (car aucun résultat « correct » n’est garanti).

  • Pendant la transition de l’heure d’été à l’heure standard, l’horloge locale se répète. Une heure locale dans la fenêtre répétée est ambiguë , car elle se produit deux fois, une fois dans l’heure d’été et une fois dans l’heure standard. Si une telle heure locale est spécifiée, cette fonction la traite comme l’heure d’été et applique le biais d’heure d’été.
  • Pendant la transition entre l’heure standard et l’heure d’été, l’horloge locale saute vers l’avant. Une heure locale dans la fenêtre ignorée n’est pas valide , car elle n’a pas de conversion UTC valide. Si une telle heure locale est spécifiée, la fonction la traite comme une heure standard et applique le biais de temps standard.

Les applications nécessitant une continuité ou une précision doivent éviter cette fonction et utiliser l’heure UTC à la place.

Spécifications

Requirement Valeur
Client minimum requis Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll
  • Last updated on