Función TzSpecificLocalTimeToSystemTime (timezoneapi.h)

Artículo
03/05/2024

Convierte una hora local en una hora en hora universal coordinada (UTC).

Sintaxis

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

Parámetros

[in, optional] lpTimeZoneInformation

Puntero a una estructura de TIME_ZONE_INFORMATION que especifica la zona horaria para la hora especificada en lpLocalTime.

Si lpTimeZoneInformation es NULL, la función usa la zona horaria activa actualmente.

[in] lpLocalTime

Puntero a una estructura SYSTEMTIME que especifica la hora local que se va a convertir. La función convierte esta hora a la hora UTC correspondiente.

[out] lpUniversalTime

Puntero a una estructura SYSTEMTIME que recibe la hora UTC.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero y la función establece los miembros de la estructura SYSTEMTIME a la que apunta lpUniversalTime a los valores adecuados.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

TzSpecificLocalTimeToSystemTime tiene en cuenta si el horario de verano (DST) está en vigor para que se convierta la hora local.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	timezoneapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll