Partilhar via


TimeZone.ToUniversalTime(DateTime) Método

Definição

Retorna o UTC (Tempo Universal Coordenado) que corresponde ao tempo especificado.

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

Parâmetros

time
DateTime

Uma data e hora.

Retornos

DateTime

Um objeto DateTime cujo valor é o UTC (Tempo Universal Coordenado) que corresponde ao time.

Comentários

Se o fuso horário local observar o horário de verão, ToUniversalTime aplicará a regra de ajuste atual ao time parâmetro ao executar a conversão.

Observação

O ToUniversalTime método reconhece apenas a regra de ajuste de horário de verão atual para o fuso horário local. Como resultado, é garantido retornar com precisão o UTC (Tempo Universal Coordenado) correspondente a uma hora local específica somente durante o período em que a regra de ajuste mais recente está em vigor. Ele poderá retornar resultados imprecisos se time for um valor histórico de data e hora que estava sujeito a uma regra de ajuste anterior.

Se o time parâmetro for um tempo ambíguo, o método pressupõe que seja uma hora padrão. (Um horário ambíguo é aquele que pode ser mapeado para uma hora padrão ou para um horário 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 retornar UTC. (Uma hora inválida é aquela que não existe devido à aplicação de regras de ajuste de horário de verão.)

Como time é interpretado em relação ao fuso horário atual no sistema atual, a data e a hora retornadas por esse método podem ser diferentes se um aplicativo for executado 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 inequívoco no tempo, use um DateTimeOffset valor para representar a hora local.

O ToUniversalTime método corresponde à sobrecarga do TimeZoneInfo.ConvertTimeToUtc(DateTime) método com um DateTime parâmetro cuja Kind propriedade não é igual DateTimeKind.Utc. Sempre que possível, use a sobrecarga do TimeZoneInfo.ConvertTimeToUtc(DateTime) método.

Aplica-se a

Confira também