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 l'offset 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 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). Cioè:
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 quando time determina l'offset del fuso orario locale. Ovvero, l'offset restituito da GetUtcOffset riflette se time rientra nell'ora solare del fuso orario o nell'ora legale.
Annotazioni
Il GetUtcOffset metodo riconosce solo la regola di regolazione dell'ora legale corrente per il fuso orario locale. Di conseguenza, è garantito che restituisca in modo accurato l'offset UTC di un'ora locale solo durante il periodo in cui è attiva la regola di rettifica più recente. Può restituire risultati imprecisi se time è un valore di data e ora cronologico soggetto a una regola di rettifica precedente.
Il GetUtcOffset metodo corrisponde al TimeZoneInfo.GetUtcOffset metodo . Quando possibile, usare il TimeZoneInfo.GetUtcOffset metodo .
Poiché il valore di data e ora rappresentato da time e l'offset di questo valore dall'ora 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 la differenza rispetto all'ora UTC.
