TimeZone.GetUtcOffset(DateTime) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

TimeZone.cs

Restituisce lo scostamento dall'ora UTC (Coordinated Universal Time) per l'ora locale specificata.

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

Parametri

time

DateTime

Valore di data e ora.

Restituisce

TimeSpan

Offset dell'ora UTC (Coordinated Universal Time) da time.

Commenti

Questo metodo restituisce l'offset o la differenza tra il parametro e l'ora time UTC (Coordinated Universal Time). Ovvero:

time = UTC + offset

Il metodo interpreta il fuso orario di time in base alla relativa Kind proprietà. Se il valore della Kind proprietà è DateTimeKind.Local o DateTimeKind.Unspecified, il metodo restituisce l'offset del fuso orario locale. Se il valore della Kind proprietà è DateTimeKind.Utc, il metodo restituisce un offset uguale a TimeSpan.Zero.

Se il fuso orario locale osserva l'ora legale, GetUtcOffset applica la regola di regolazione corrente a time quando determina l'offset del fuso orario locale. Vale a dire, l'offset restituito GetUtcOffset riflette se time rientra nell'ora standard del fuso orario o nell'ora legale.

Nota

Il GetUtcOffset metodo riconosce solo la regola di regolazione dell'ora legale corrente per il fuso orario locale. Di conseguenza, è garantito restituire in modo accurato l'offset UTC di un'ora locale solo durante il periodo in cui la regola di regolazione più recente è effettiva. Può restituire risultati non accurati se time è un valore di data e ora cronologico soggetto a una regola di regolazione precedente.

Il GetUtcOffset metodo corrisponde al TimeZoneInfo.GetUtcOffset metodo . Se possibile, usare il TimeZoneInfo.GetUtcOffset metodo .

Poiché il valore di data e ora rappresentato da time e l'offset di questo valore da UTC non sono strettamente associati, un valore di data e ora locale o non specificato può restituire un valore di offset diverso quando viene eseguito in computer diversi o quando viene eseguito nello stesso computer in fusi orari diversi. Se questo comportamento è indesiderato, usare invece un DateTimeOffset valore. Il DateTimeOffset tipo di dati associa strettamente un valore di data e ora con il relativo offset da UTC.

Vedi anche

• GetUtcOffset(DateTime)