TimeZone.GetUtcOffset(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 l'offset en temps universel coordonné (UTC, Coordinated Universal Time) pour le fuseau horaire spécifié.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset (DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParamètres
- time
- DateTime
Valeur de date et heure.
Retours
L'offset du temps universel (UTC, Universal Time Coordinated) de time.
Remarques
Cette méthode retourne le décalage, ou la différence, entre le paramètre et le time temps universel coordonné (UTC). Plus précisément :
time = UTC + décalage
La méthode interprète le fuseau horaire de en fonction de time sa Kind propriété. Si la valeur de la Kind propriété est DateTimeKind.Local ou DateTimeKind.Unspecified, la méthode retourne le décalage du fuseau horaire local. Si la valeur de la Kind propriété est DateTimeKind.Utc, la méthode retourne un décalage égal à TimeSpan.Zero.
Si le fuseau horaire local observe l’heure d’été, GetUtcOffset applique la règle d’ajustement actuelle à time lors de la détermination du décalage du fuseau horaire local. Autrement dit, le décalage retourné par GetUtcOffset indique si time se situe à l’heure normale du fuseau horaire ou à l’heure d’été.
Notes
La GetUtcOffset méthode reconnaît uniquement la règle d’ajustement actuelle de l’heure d’été pour le fuseau horaire local. Par conséquent, il est garanti de retourner avec précision le décalage UTC d’une heure locale 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 inexacts si time est une valeur de date et d’heure historique qui a été soumise à une règle d’ajustement précédente.
La GetUtcOffset méthode correspond à la TimeZoneInfo.GetUtcOffset méthode . Dans la mesure du possible, utilisez la TimeZoneInfo.GetUtcOffset méthode .
Étant donné que la valeur de date et d’heure représentée par time et le décalage utc de cette valeur ne sont pas étroitement couplées, une valeur de date et d’heure locale ou non spécifiée peut retourner une valeur de décalage différente lorsqu’elle est exécutée sur des ordinateurs différents ou quand elle est exécutée sur le même ordinateur sous des fuseaux horaires différents. Si ce comportement n’est pas souhaitable, utilisez une DateTimeOffset valeur à la place. Le DateTimeOffset type de données couple étroitement une valeur de date et d’heure avec son décalage par rapport à UTC.
