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 le décalage UTC (Temps universel coordonné) pour l’heure locale spécifiée.
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 d’heure.
Retours
Décalage utc (Temps universel coordonné) 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 la base 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 time d’ajustement actuelle lors de la détermination du décalage du fuseau horaire local. Autrement dit, le décalage retourné par GetUtcOffset reflète si time l’heure standard du fuseau horaire ou son heure d’été.
Note
La GetUtcOffset 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 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 incorrects s’il time s’agit d’une valeur de date et d’heure historique 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 lors de l’exécution sur différents ordinateurs ou lorsqu’elle est exécutée sur le même ordinateur sous différents fuseaux horaires. Si ce comportement n’est pas souhaitable, utilisez plutôt une DateTimeOffset valeur. Le DateTimeOffset type de données couple étroitement une valeur de date et d’heure avec son décalage par rapport à UTC.
