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.
|
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de