Função TzSpecificLocalTimeToSystemTime (timezoneapi.h)

Artigo
03/02/2024

Converte uma hora local em um horário em UTC (Tempo Universal Coordenado).

Sintaxe

BOOL TzSpecificLocalTimeToSystemTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpLocalTime,
  [out]          LPSYSTEMTIME                lpUniversalTime
);

Parâmetros

[in, optional] lpTimeZoneInformation

Um ponteiro para uma estrutura TIME_ZONE_INFORMATION que especifica o fuso horário para a hora especificada em lpLocalTime.

Se lpTimeZoneInformation for NULL, a função usará o fuso horário ativo no momento.

[in] lpLocalTime

Um ponteiro para uma estrutura SYSTEMTIME que especifica a hora local a ser convertida. A função converte desta vez para a hora UTC correspondente.

[out] lpUniversalTime

Um ponteiro para uma estrutura SYSTEMTIME que recebe a hora UTC.

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 lpUniversalTime para os valores apropriados.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

TzSpecificLocalTimeToSystemTime leva em conta se o horário de verão (DST) está em vigor para a hora local a ser convertida.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	timezoneapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll