TimeZone.ToUniversalTime(DateTime) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne le temps universel coordonné (UTC) qui correspond à une heure spécifiée.
public:
virtual DateTime ToUniversalTime(DateTime time);public virtual DateTime ToUniversalTime(DateTime time);abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTimePublic Overridable Function ToUniversalTime (time As DateTime) As DateTimeParamètres
- time
- DateTime
Date et heure.
Retours
Objet DateTime dont la valeur est le temps universel coordonné (UTC) qui correspond à time.
Remarques
Si le fuseau horaire local observe l’heure d’été, ToUniversalTime applique la règle d’ajustement actuelle au paramètre lors de l’exécution time de la conversion.
Note
La ToUniversalTime méthode reconnaît uniquement la règle d’ajustement de l’heure d’été actuelle pour le fuseau horaire local. Par conséquent, il est garanti de retourner avec précision le temps universel coordonné (UTC) correspondant à une heure locale particulière uniquement pendant la période pendant laquelle la règle d’ajustement la plus récente est en vigueur. Il peut retourner des résultats incorrects s’il time s’agit d’une valeur de date et d’heure historique soumise à une règle d’ajustement précédente.
Si le time paramètre est une heure ambiguë, la méthode suppose qu’il s’agit d’une heure standard. (Une heure ambiguë est une heure qui peut être mappées à une heure standard ou à une heure d’été dans le fuseau horaire local.) S’il time s’agit d’une heure non valide, la méthode soustrait simplement l’heure locale du décalage UTC du fuseau horaire local pour retourner l’heure UTC. (Il s’agit d’une heure non valide qui n’existe pas en raison de l’application des règles d’ajustement de l’heure d’été.)
Étant donné qu’elle time est interprétée par rapport au fuseau horaire actuel sur le système actuel, la date et l’heure retournées par cette méthode peuvent différer si une application est exécutée sur différents ordinateurs ou sur le même ordinateur avec des fuseaux horaires différents. Dans les cas où une valeur de date et d’heure doit représenter un point dans le temps unique et non ambigu, utilisez une DateTimeOffset valeur pour représenter l’heure locale.
La ToUniversalTime méthode correspond à la TimeZoneInfo.ConvertTimeToUtc(DateTime) surcharge de méthode avec un DateTime paramètre dont Kind la propriété n’est pas égale DateTimeKind.Utc. Dans la mesure du possible, utilisez la surcharge de méthode TimeZoneInfo.ConvertTimeToUtc(DateTime) .
