Função SystemTimeToTzSpecificLocalTime (timezoneapi.h)
Converte uma hora em UTC (Tempo Universal Coordenado) em uma hora local correspondente de um fuso horário especificado.
Sintaxe
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
Parâmetros
[in, optional] lpTimeZoneInformation
Um ponteiro para uma estrutura de TIME_ZONE_INFORMATION que especifica o fuso horário de interesse.
Se lpTimeZone for NULL, a função usará o fuso horário ativo no momento.
[in] lpUniversalTime
Um ponteiro para uma estrutura SYSTEMTIME que especifica a hora UTC a ser convertida. A função converte esse tempo universal no horário local correspondente do fuso horário especificado.
[out] lpLocalTime
Um ponteiro para uma estrutura SYSTEMTIME que recebe a hora local.
Retornar valor
Se a função for bem-sucedida, o valor retornado será diferente de zero e a função definirá os membros da estrutura SYSTEMTIME apontada por lpLocalTime para os valores de hora local apropriados.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função SystemTimeToTzSpecificLocalTime leva em conta se o horário de verão (DST) está em vigor para a hora local na qual a hora do sistema deve ser convertida.
A função SystemTimeToTzSpecificLocalTime pode calcular a hora local incorretamente nas seguintes condições:
- O fuso horário usa um deslocamento UTC diferente para os anos antigos e novos.
- A hora UTC a ser convertida e a hora local calculada estão em anos diferentes.
Exemplos
Para obter um exemplo, consulte Recuperando o tempo de Last-Write.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | timezoneapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |