TimeZone.GetUtcOffset(DateTime) Méthode

Définition

Retourne l'offset en temps universel coordonné (UTC, Coordinated Universal Time) pour le fuseau horaire spécifié.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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.A date and time value.

Retours

L'offset du temps universel (UTC, Universal Time Coordinated) de time.The Coordinated Universal Time (UTC) offset from time.

Remarques

Cette méthode retourne le décalage ou la différence entre le paramètre time et le temps universel coordonné (UTC, Universal Time Coordinated).This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). Plus précisément :That is:

time= UTC + décalagetime = UTC + offset

La méthode interprète le fuseau horaire de time en fonction de sa Kind propriété.The method interprets the time zone of time based on its Kind property. Si la valeur de la Kind propriété est DateTimeKind.Local ou DateTimeKind.Unspecified, la méthode retourne l’offset du fuseau horaire local.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. Si la valeur de la Kind propriété est DateTimeKind.Utc, la méthode retourne un offset égal à TimeSpan.Zero.If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to 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.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. Autrement dit, le décalage retourné par GetUtcOffset reflète la time valeur de l’heure d’hiver du fuseau horaire ou de l’heure d’été.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Notes

La GetUtcOffset méthode reconnaît uniquement la règle de réglage de l’heure d’été actuelle pour le fuseau horaire local.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. 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 appliquée.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. Elle peut retourner des résultats inexacts si time est une valeur de date et d’heure historique qui était soumise à une règle de réglage précédente.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

La GetUtcOffset méthode correspond à la TimeZoneInfo.GetUtcOffset méthode.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. Dans la mesure du possible TimeZoneInfo.GetUtcOffset , utilisez la méthode.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

Étant donné que la valeur de date et time d’heure représentée par et le décalage de cette valeur par rapport à l’heure UTC ne sont pas étroitement couplés, 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 différents ordinateurs ou lorsqu’elle est exécutée sur le même ordinateur sous fuseaux horaires différents.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. Si ce comportement n’est pas souhaitable, utilisez DateTimeOffset une valeur à la place.If this behavior is undesirable, use a DateTimeOffset value instead. Le DateTimeOffset type de données couple étroitement une valeur de date et d’heure avec son décalage par rapport à l’heure UTC.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

S’applique à

Voir aussi