TimeZone.ToUniversalTime(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'ora UTC (Coordinated Universal Time) corrispondente a un'ora specificata.
public:
virtual DateTime ToUniversalTime(DateTime time);public virtual DateTime ToUniversalTime (DateTime time);abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTimePublic Overridable Function ToUniversalTime (time As DateTime) As DateTimeParametri
- time
- DateTime
Data e ora.
Restituisce
Oggetto DateTime il cui valore è l'ora UTC (Coordinated Universal Time) corrispondente a time.
Commenti
Se il fuso orario locale osserva l'ora legale, ToUniversalTime applica la regola di regolazione corrente al time parametro durante l'esecuzione della conversione.
Nota
Il ToUniversalTime metodo riconosce solo la regola di regolazione dell'ora legale corrente per il fuso orario locale. Di conseguenza, è garantito restituire in modo accurato l'ora UTC (Coordinated Universal Time) corrispondente a una determinata 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.
Se il parametro è un tempo ambiguo, il time metodo presuppone che sia un'ora standard. Un'ora ambigua è una che può essere mappata a un'ora standard o a un'ora legale nel fuso orario locale. Se time è un'ora non valida, il metodo sottrae semplicemente l'ora locale dall'offset UTC del fuso orario locale per restituire l'ora UTC. Un'ora non valida è una che non esiste a causa dell'applicazione delle regole di regolazione dell'ora legale.
Poiché time viene interpretato in relazione al fuso orario corrente nel sistema corrente, la data e l'ora restituita da questo metodo possono variare se un'applicazione viene eseguita in computer diversi o nello stesso computer con fusi orari diversi. Per i casi in cui un valore di data e ora deve rappresentare un singolo punto non ambiguo nel tempo, usare un DateTimeOffset valore per rappresentare l'ora locale.
Il ToUniversalTime metodo corrisponde all'overload del TimeZoneInfo.ConvertTimeToUtc(DateTime) metodo con un DateTime parametro la cui Kind proprietà non è uguale DateTimeKind.Utca . Se possibile, usare l'overload del TimeZoneInfo.ConvertTimeToUtc(DateTime) metodo.
