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

Confira também

Getsystemtime

Gettimezoneinformation

SYSTEMTIME

Hora do sistema

TIME_ZONE_INFORMATION

Funções de tempo

TzSpecificLocalTimeToSystemTime