Função TzSpecificLocalTimeToSystemTime (timezoneapi.h)
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 |