TimeZone.GetUtcOffset(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 deslocamento do Tempo Universal Coordenado (UTC) para a hora local especificada.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset(DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanParâmetros
- time
- DateTime
Um valor de data e hora.
Devoluções
O deslocamento do Tempo Universal Coordenado (UTC) em relação a time.
Observações
Este método devolve o deslocamento, ou diferença, entre o time parâmetro e o Tempo Universal Coordenado (UTC). Isso é:
time = UTC + deslocamento
O método interpreta o fuso horário de time com base na sua Kind propriedade. Se o valor da Kind propriedade for DateTimeKind.Local ou DateTimeKind.Unspecified, o método devolve o deslocamento do fuso horário local. Se o valor da Kind propriedade for DateTimeKind.Utc, o método devolve um deslocamento igual a TimeSpan.Zero.
Se o fuso horário local observar o horário de verão, GetUtcOffset aplica-se a regra de ajuste atual ao time determinar o deslocamento do fuso horário local. Ou seja, o deslocamento devolvido por GetUtcOffset reflete se time corresponde à hora padrão do fuso horário ou à sua hora de verão.
Note
O GetUtcOffset 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 deslocamento UTC de uma 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.
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 deste valor em relação ao UTC não estão fortemente acoplados, um valor local ou não especificado de data e hora pode devolver um valor de deslocamento diferente quando executado em computadores diferentes ou no mesmo computador sob fusos horários diferentes. Se este comportamento for indesejável, use um DateTimeOffset valor em vez disso. O DateTimeOffset tipo de dados acopla de forma estreita um valor de data e hora ao seu deslocamento em relação ao UTC.