estructura TIME_ZONE_INFORMATION (timezoneapi.h)

Especifica la configuración de una zona horaria.

Sintaxis

typedef struct _TIME_ZONE_INFORMATION {
  LONG       Bias;
  WCHAR      StandardName[32];
  SYSTEMTIME StandardDate;
  LONG       StandardBias;
  WCHAR      DaylightName[32];
  SYSTEMTIME DaylightDate;
  LONG       DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;

Miembros

Bias

La diferencia actual para la conversión de hora local en este equipo, en minutos. El sesgo es la diferencia, en minutos, entre la hora universal coordinada (UTC) y la hora local. Todas las traducciones entre utc y hora local se basan en la fórmula siguiente:

UTC = hora local + sesgo

Este miembro es obligatorio.

StandardName[32]

Descripción de la hora estándar. Por ejemplo, "EST" podría indicar hora estándar oriental. La cadena se devolverá sin cambios por la función GetTimeZoneInformation . Esta cadena puede estar vacía.

StandardDate

Estructura SYSTEMTIME que contiene una fecha y hora local cuando se produce la transición del horario de verano a la hora estándar en este sistema operativo. Si la zona horaria no admite el horario de verano o si el autor de la llamada necesita deshabilitar el horario de verano, el miembro wMonth de la estructura SYSTEMTIME debe ser cero. Si se especifica esta fecha, también se debe especificar el miembro DaylightDate de esta estructura.

De lo contrario, el sistema supone que los datos de zona horaria no son válidos y no se aplicará ningún cambio.

Para seleccionar el día correcto en el mes, establezca el miembro wYear en cero, los miembros wHour y wMinute en el tiempo de transición, el miembro wDayOfWeek al día laborable adecuado y el miembro wDay para indicar la aparición del día de la semana dentro del mes (de 1 a 5, donde 5 indica la repetición final durante el mes si ese día de la semana no se produce 5 veces).

Con esta notación, especifique 02:00 el primer domingo de abril de la siguiente manera: wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Especifique 02:00 el último jueves de octubre de la siguiente manera: wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.

Si el miembro wYear no es cero, la fecha de transición es absoluta; solo se producirá una vez. De lo contrario, es una fecha relativa que se produce anualmente.

StandardBias

Valor de sesgo que se va a usar durante las traducciones de hora local que se producen durante el tiempo estándar. Este miembro se omite si no se proporciona un valor para el miembro StandardDate .

Este valor se agrega al valor del miembro Bias para formar el sesgo usado durante el tiempo estándar. En la mayoría de las zonas horarias, el valor de este miembro es cero.

DaylightName[32]

Descripción del horario de verano. Por ejemplo, "PDT" podría indicar el horario de verano del Pacífico. La cadena se devolverá sin cambios por la función GetTimeZoneInformation . Esta cadena puede estar vacía.

DaylightDate

Estructura SYSTEMTIME que contiene una fecha y hora local cuando se produce la transición de la hora estándar al horario de verano en este sistema operativo. Si la zona horaria no admite el horario de verano o si el autor de la llamada necesita deshabilitar el horario de verano, el miembro wMonth de la estructura SYSTEMTIME debe ser cero. Si se especifica esta fecha, también se debe especificar el miembro StandardDate de esta estructura.

De lo contrario, el sistema supone que los datos de zona horaria no son válidos y no se aplicará ningún cambio.

Para seleccionar el día correcto en el mes, establezca el miembro wYear en cero, los miembros wHour y wMinute en el tiempo de transición, el miembro wDayOfWeek al día laborable adecuado y el miembro wDay para indicar la aparición del día de la semana dentro del mes (de 1 a 5, donde 5 indica la repetición final durante el mes si ese día de la semana no se produce 5 veces).

Si el miembro wYear no es cero, la fecha de transición es absoluta; solo se producirá una vez. De lo contrario, es una fecha relativa que se produce anualmente.

DaylightBias

Valor de sesgo que se va a usar durante las traducciones de hora local que se producen durante el horario de verano. Este miembro se omite si no se proporciona un valor para el miembro DaylightDate .

Este valor se agrega al valor del miembro Bias para formar el sesgo utilizado durante el horario de verano. En la mayoría de las zonas horarias, el valor de este miembro es –60.

Comentarios

La configuración de cada zona horaria se almacena en la siguiente clave del Registro:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

Cada entrada de zona horaria incluye los siguientes valores del Registro.

Valor del Registro Tipo Descripción
Pantalla REG_SZ El nombre para mostrar.
Dlt REG_SZ Descripción del horario de verano.
MUI_Display REG_SZ Nombre para mostrar como una cadena del formulario @path,-stringID[;comentario]. Para obtener más información, consulte MUI.
MUI_Dlt REG_SZ Descripción de la hora de verano como una cadena de la forma @path,-stringID[;comentario].
MUI_Std REG_SZ Descripción de la hora estándar como una cadena de la forma @path,-stringID[;comentario].
Std REG_SZ Descripción de la hora estándar.
TZI REG_BINARY La siguiente información de zona horaria.
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;

 

Para obtener más información sobre la clave DST dinámica , consulte DYNAMIC_TIME_ZONE_INFORMATION.

StandardName y DaylightName se localizan según el idioma de la interfaz de usuario predeterminado del usuario actual.

Ejemplos

Para obtener un ejemplo, vea SetTimeZoneInformation.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado timezoneapi.h (incluya Windows.h)

Consulte también

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation