Função SystemTimeToTzSpecificLocalTime (timezoneapi.h)

Artigo
03/02/2024

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