TimeZone.ToUniversalTime(DateTime) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

TimeZone.cs

Retourne le temps universel (UTC, Universal Time Coordinated) 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 -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Paramètres

time

DateTime

Date et heure.

Retours

DateTime

Un objet DateTime dont la valeur est le temps universel (UTC, Universal Time Coordinated) qui correspond à time.

Remarques

Si le fuseau horaire local observe l’heure d’été, ToUniversalTime applique la règle d’ajustement actuelle au time paramètre lors de l’exécution de la conversion.

Notes

La ToUniversalTime méthode reconnaît uniquement la règle d’ajustement d’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 au cours de laquelle la règle d’ajustement la plus récente est en vigueur. Il peut retourner des résultats incorrects si time est une valeur de date et d’heure historique qui a été 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.) Si time est une heure non valide, la méthode soustrait simplement l’heure locale du décalage UTC du fuseau horaire local pour retourner UTC. (Une heure non valide est une heure qui n’existe pas en raison de l’application des règles d’ajustement de l’heure d’été.)

Étant donné que time est interprété 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 des ordinateurs différents ou sur le même ordinateur avec des fuseaux horaires différents. Pour les cas où une valeur de date et d’heure doit représenter un point unique et non ambigu dans le temps, utilisez une DateTimeOffset valeur pour représenter l’heure locale.

La ToUniversalTime méthode correspond à la surcharge de méthode TimeZoneInfo.ConvertTimeToUtc(DateTime) 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 TimeZoneInfo.ConvertTimeToUtc(DateTime) méthode.

Voir aussi

• ConvertTimeToUtc(DateTime)