TimeZone.ToUniversalTime(DateTime) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve o Tempo Universal Coordenado (UTC) que corresponde a uma hora especificada.
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 DateTimeParâmetros
- time
- DateTime
Uma data e hora.
Devoluções
Um DateTime objeto cujo valor é o Tempo Universal Coordenado (UTC) que corresponde a time.
Observações
Se o fuso horário local observar o horário de verão, ToUniversalTime aplica a regra de ajuste atual ao time parâmetro ao realizar a conversão.
Note
O ToUniversalTime método reconhece apenas a regra atual de ajuste do horário de verão para o fuso horário local. Como resultado, é garantido o retorno preciso do Tempo Universal Coordenado (UTC) correspondente a uma determinada hora local apenas durante o período em que a regra de ajuste mais recente está em vigor. Pode devolver resultados imprecisos se time for uma data e hora históricas sujeitas a uma regra de ajuste anterior.
Se o time parâmetro for um tempo ambíguo, o método assume que é um tempo padrão. (Uma hora ambígua é aquela que pode ser mapeada tanto para uma hora padrão como para uma hora de verão no fuso horário local.) Se time for uma hora inválida, o método simplesmente subtrai a hora local do deslocamento UTC do fuso horário local para devolver UTC. (Uma hora inválida é aquela que não existe devido à aplicação das regras de ajuste do horário de verão.)
Como time é interpretado em relação ao fuso horário atual no sistema atual, a data e hora devolvidas por este método podem diferir se uma aplicação for executada em computadores diferentes ou no mesmo computador com fusos horários diferentes. Para casos em que um valor de data e hora deve representar um único ponto no tempo inequívoco, use um DateTimeOffset valor para representar a hora local.
O ToUniversalTime método corresponde à TimeZoneInfo.ConvertTimeToUtc(DateTime) sobrecarga do método com um DateTime parâmetro cuja Kind propriedade não é igual DateTimeKind.Utca . Sempre que possível, use o TimeZoneInfo.ConvertTimeToUtc(DateTime) método overload.
