Partilhar via


TimeZone.GetUtcOffset(DateTime) Método

Definição

Retorna a diferença UTC (Tempo Universal Coordenado) para a hora local especificada.

public:
 abstract TimeSpan GetUtcOffset(DateTime time);
public abstract TimeSpan GetUtcOffset (DateTime time);
abstract member GetUtcOffset : DateTime -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parâmetros

time
DateTime

Um valor de data e hora.

Retornos

A diferença UTC (Tempo Universal Coordenado) de time.

Comentários

Esse método retorna o deslocamento ou a diferença entre o time parâmetro e o UTC (Tempo Universal Coordenado). Ou seja:

time = UTC + deslocamento

O método interpreta o fuso horário de time com base em sua Kind propriedade. Se o valor da Kind propriedade for DateTimeKind.Local ou DateTimeKind.Unspecified, o método retornará o deslocamento do fuso horário local. Se o valor da Kind propriedade for DateTimeKind.Utc, o método retornará um deslocamento igual a TimeSpan.Zero.

Se o fuso horário local observar o horário de verão, GetUtcOffset aplicará a regra de ajuste atual ao time determinar o deslocamento do fuso horário local. Ou seja, o deslocamento retornado por GetUtcOffset reflete se time cai no horário padrão do fuso horário ou no horário de verão.

Observação

O GetUtcOffset 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 deslocamento UTC de uma hora local 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.

O GetUtcOffset método corresponde ao TimeZoneInfo.GetUtcOffset método . Sempre que possível, use o TimeZoneInfo.GetUtcOffset método .

Como o valor de data e hora representado por time e o deslocamento desse valor de UTC não estão firmemente acoplados, um valor de data e hora local ou não especificado pode retornar um valor de deslocamento diferente quando executado em computadores diferentes ou quando executado no mesmo computador em fusos horários diferentes. Se esse comportamento for indesejável, use um DateTimeOffset valor em vez disso. O DateTimeOffset tipo de dados casa fortemente um valor de data e hora com seu deslocamento de UTC.

Aplica-se a

Confira também