Partager via


TimeZone.GetUtcOffset(DateTime) Méthode

Définition

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 -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Paramè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.

S’applique à

Voir aussi