Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Convertit l’heure locale spécifiée en heure correspondante 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 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 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
TzSpecificLocalTimeToSystemTime prend en compte si l’heure d’été (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.
- 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 l’heure locale spécifiée est ambiguë ou non valide, la fonction la traite comme l’heure d’été et applique le biais d’heure d’été. 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 XP [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | Applications UWP] |
| plateforme cible | Fenêtres |
| Header | timezoneapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |