TimeZone.ToLocalTime(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 a hora local que corresponde a um valor de data e hora especificados.
public:
virtual DateTime ToLocalTime(DateTime time);public virtual DateTime ToLocalTime(DateTime time);abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTimePublic Overridable Function ToLocalTime (time As DateTime) As DateTimeParâmetros
- time
- DateTime
Uma Hora Coordenada em Tempo Universal (UTC).
Devoluções
Um DateTime objeto cujo valor é o tempo local correspondente a time.
Observações
A tabela seguinte mostra a relação entre o time parâmetro e o DateTime valor devolvido por este método.
time Parâmetro |
Comportamento | Valor de retorno |
|---|---|---|
| Uma Hora Coordenada em Tempo Universal (UTC) (DateTimeKind.Utc). | Converte a hora do UTC para a hora local. | Um DateTime objeto cujo valor é o tempo local correspondente a time. |
| Hora local (DateTimeKind.Local). | Não é necessária conversão. | O mesmo DateTime valor representado pelo time parâmetro. |
| Uma hora não especificada (DateTimeKind.Unspecified). | Assume que a hora é UTC e converte-a de UTC para a hora local. | Um DateTime objeto cujo valor é o tempo local correspondente a time. |
Se o fuso horário local observar o horário de verão, ToLocalTime aplica a regra de ajuste atual ao time realizar a conversão.
Note
O ToLocalTime 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 da hora local correspondente a uma determinada hora UTC 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 ToLocalTime método corresponde ao TimeZoneInfo.ConvertTimeFromUtc método com o parâmetro destinationTimeZone definido em TimeZoneInfo.Local. Sempre que possível, use o TimeZoneInfo.ConvertTimeFromUtc método.
Notas para Herdeiros
Embora não seja obrigatório, na maioria dos casos classes derivadas devem sobrepor-se à implementação padrão deste método. O comportamento da implementação padrão depende da Kind propriedade do time parâmetro. Se o seu valor for Local, este método retorna time inalterado. Se o seu valor for ou Utc , Unspecifiedeste método assume time que é UTC e converte-o para o tempo do sistema local sem chamar o GetUtcOffset(DateTime) método.
