Condividi tramite


TimeZone.ToUniversalTime(DateTime) Metodo

Definizione

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 -> DateTime
Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parametri

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.

Si applica a

Vedi anche