Partilhar via


Função TzSpecificLocalTimeToSystemTimeEx (timezoneapi.h)

Converte a hora local especificada, com configurações de DST (horário de verão dinâmico), para a hora correspondente em UTC (Tempo Universal Coordenado).

Sintaxe

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

Parâmetros

[in, optional] lpTimeZoneInformation

Um ponteiro para uma estrutura de DYNAMIC_TIME_ZONE_INFORMATION que especifica as configurações de fuso horário e DST dinâmico.

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.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero e a função definirá os membros da estrutura SYSTEMTIMEapontados 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.

Observações

TzSpecificLocalTimeToSystemTimeEx leva em conta se o DST está em vigor para a hora local a ser convertida.

Importante

Os horários locais a seguir, próximos às transições de DST, podem ser ambíguos ou inválidos e podem resultar em um comportamento inesperado (já que não há nenhum resultado "correto" garantido).

  • Durante a transição do horário de verão para o horário padrão, o relógio local se repete. Uma hora local dentro da janela repetida é ambígua porque ocorre duas vezes, uma no horário de verão e uma vez no horário padrão. Se essa hora local for especificada, essa função a tratará como horário de verão e aplicará o viés de horário de verão.
  • Durante a transição do horário padrão para o horário de verão, o relógio local avança. Uma hora local dentro da janela ignorada é inválida porque não tem uma conversão UTC válida. Se essa hora local for especificada, a função a tratará como horário padrão e aplicará o viés de tempo padrão.

Os aplicativos que exigem continuidade ou precisão devem evitar essa função e usar o tempo UTC.

Requirements

Requirement Value
Cliente mínimo suportado Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header timezoneapi.h (inclua Windows.h)
Library Kernel32.lib
de DLL Kernel32.dll