TimeZone.GetUtcOffset(DateTime) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParametri
- time
- DateTime
Valore di data e ora.
Restituisce
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.
