wrapper.timezone

Compatibilidad :3.3.6
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

La propiedad timezone permite definir la zona horaria en la que se ejecutará el Wrapper.

A partir de la versión 3.5.29, se recomienda utilizar identificadores de zona horaria de la IANA. Estos identificadores se componen del nombre de un continente u océano seguido de una barra y el nombre de una ubicación representativa dentro de esta área (normalmente el nombre de la ciudad más grande). Por ejemplo, 'America/Los_Angeles' representa la zona horaria de la hora del Pacífico. Puede encontrar una lista completa de los identificadores aquí.

Otros valores posibles son 'UTC', opcionalmente seguido de '+(-)hhmm', para especificar el desplazamiento de la hora universal coordinada, o 'SYSTEM' (3.5.46) para especificar la zona horaria local de sistema en el que se ejecuta el Wrapper.

Para compatibilidad con versiones anteriores, también se permite una lista de abreviaturas de zonas horarias (e.g. MST, GMT, JST, etc.). Sin embargo, Java los ha depreciado porque a veces se usa la misma abreviatura para representar varias zonas horarias. No se recomienda utilizarlos en la configuración del Wrapper porque un mismo código puede dar lugar a distintas interpretaciones según el sistema operativo.

Con zonas horarias IANA time zones, la misma configuración siempre producirá la misma hora, independientemente de la plataforma.

Ejemplos de definición de la zona horaria:
wrapper.timezone=America/Los_Angeles  # Set the Timezone to Pacific Time
                                      # using a IANA identifier

wrapper.timezone=CET                  # Set the Timezone to Central European Time
                                      # using abbreviation

wrapper.timezone=UTC+0100             # Set the Timezone to UTC+01

wrapper.timezone=UTC-0530             # Set the Timezone to UTC-0530
                                      # (-5 hours and 30 minutes offset to UTC) 

NOTA

Cambiar la zona horaria afectará las marcas de tiempo en todas las salidas de registro (en las ediciones Estándar y Profisional), así como la propiedad wrapper.timer.<n>.interval y las configuraciones de correo electrónico (en la edición Profesional).

A partir de la versión 3.5.35, la zona horaria, si se especifica, se pasará a la JVM usando la opción 'user.timezone'. Esto garantiza que la hora esté sincronizada entre el Wrapper y la aplicación Java.

Es posible especificar una zona horaria diferente para la aplicación Java configurando la propiedad wrapper.java.timezone.

wrapper.timezone.folder

Compatibilidad :3.5.29
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Esta propiedad es obligatoria cuando se usa un identificador IANA, y le permite especificar la ruta a un directorio que contiene los archivos de origen de la base de datos de zona horaria de IANA (IANA Time Zone Database).

La Base de Datos de Zona Horaria de IANA se actualiza periódicamente para tener en cuenta los cambios en las horas locales de todo el mundo. La base de datos proporciona varios archivos (uno para cada región del mundo) que se agrupan en un solo paquete y están disponibles para descarga en el sitio web de la Autoridad de Números Asignados de Internet (Internet Assigned Number Authority - IANA).

Estos archivos se llaman:

  • africa

    (África)
  • asia

    (Asia)
  • australasia

    (Australasia)
  • europe

    (Europa)
  • northamerica

    (América del norte)
  • southamerica

    (Sudamerica)

Seleccione el archivo con el nombre de la región que contiene la zona horaria seleccionada. Por ejemplo, el archivo 'northamerica' se usaría en la zona horaria 'America/Los_Angeles'. A continuación, extraiga el archivo y colóquelo en la ubicación especificada por la propiedad wrapper.timezone.file. También puede poner otros archivos en la misma carpeta si planea cambiar wrapper.timezone a una zona horaria ubicada en otra región.

Dado que Java también utiliza la base de datos de zonas horarias de la IANA, la hora utilizada por su aplicación Java será coherente con la hora del Wrapper, siempre que utilicen el mismo identificador de zona horaria. Sin embargo, es posible que deba confirmar que la versión de la base de datos de zonas horarias sea la misma que la proporcionada en su versión de JRE. Una lista de las versiones por lanzamiento de JRE está disponible en el sitio web de Oracle (en inglés).

ADVERTENCIA

Hasta la versión 3.,5.44, había un problema en el que el Wrapper se colgaba al iniciarse si el archivo 'etcétera' (parte de la base de datos IANA tz estaba presente en la ubicación especificada por la propiedad. Eliminar este archivo resolvería el problema. Esto se ha corregido en la versión 3.5.45.

wrapper.timezone.use_summer_time

Compatibilidad :3.3.7
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

A veces, habrá casos en los que desee desactivar el Horario de Verano (ahorro de energía diurna) por algunas razones, como ejecutar el Wrapper en diferentes servidores en diferentes zonas horarias y mantener los archivos de registro con las mismas marcas de tiempo, sin cambiar la zona horaria del sistema. Con esta propiedad, puede especificar si el Wrapper cambiará la información de la zona horaria a Horario de Verano/Invierno automáticamente, si se ha establecido la propiedad wrapper.timezone.

El valor predeterminado es "TRUE".

Ejemplo: (Habilitar el cambio de hora a Horario de Verano/Invierno)
wrapper.timezone.use_summer_time=TRUE

NOTA

Si una zona horaria no usa Hora de Verano, esta propiedad se ignorará. Esto también significa que el Wrapper no respetará la propiedad si se estableció la zona horaria a "UTC+/-xxxx". Además, cuando se ha definido un Horario de Verano (luz diurna) para wrapper.timezone, esta propiedad tampoco tiene efecto.

wrapper.timezone.debug_timestamps

Compatibilidad :3.5.30
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Esta propiedad permite mostrar el desplazamiento de la zona horaria actual en las marcas de tiempo de las salidas del registro. Al usar una zona horaria de la IANA, se agregará una letra adicional para indicar si el horario de verano está vigente ('D' para el horario de verano, 'S' para el horario estándar).

El valor predeterminado es FALSE, lo que significa que las marcas de tiempo se mostrarán sin esta información adicional.

Ejemplo: (salida de registro con wrapper.timezone.debug_timestamps=TRUE)
STATUS | 2016/03/16 17:54:44 GMT-07:00 D | wrapper  | --> Wrapper Started as Console

Lista de los identificadores de zona horaria admitidos

Zonas horarias de IANA

Para una lista completa de los identificadores de zonas horarias de IANA, consulte esta página.

Abreviaturas de zonas horarias (obsoletas)

NameOffset to UTC0 in hoursDescription
IDLW -12.0 Línea Internacional de Cambio de Fecha Oeste
HAST -10.0 Hora estándar de Hawái-Aleutiano*
HDT -9.0 Hora de Verano de Hawái-Aleutiano**
AKST -9.0 Hora Estándar de Alaska*
AKDT -8.0 Hora de Verano de Alaska**
YST -9.0 Hora Estándar de Yukon*
YDT -8.0 Hora de Verano de Yukon**
PST -8.0 Hora Estándar del Pacífico*
PT -8.0 Hora del Pacífico*
PDT -7.0 Hora de Verano del Pacífico**
MST -7.0 Hora Estándar de la Montaña*
MDT -6.0 Hora de Verano de la Montaña**
CST -6.0 Hora Estándar Central
CDT -5.0 Hora de Verano Central**
EST -5.0 Hora Estándar del Este*
VST -4.5 Hora Estándar de Venezuela
EDT -4.0 Hora de Verano del Este**
AST -4.0 Hora Estándar del Atlántico*
ADT -3.0 Hora de Verano del Atlántico**
NST -3.5 Hora Estándar de Terranova*
NDT -2.5 Hora de Verano de Terranova**
GMT 0 Hora Media de Greenwich*
WET 0 Hora de Europa Occidental*
WEST +1.0 Hora de Verano de Europa Occidental**
WEDT +1.0 Hora de Verano de Europa Occidental**
BST +1.0 Horario de Verano Británico**
WAT +1.0 Hora de África Occidental
CET +1.0 Hora de Europa Central*
CEST +2.0 Hora de Verano de Europa Central**
CEDT +2.0 Hora de Verano de Europa Central**
EET +2.0 Hora de Europa Oriental*
EEST +3.0 Hora de Verano de Europa Oriental**
EAT +3.0 Hora de África Oriental
BT +3.0 Hora de Bagdad
MSK +3.0 Hora de Moscú*
MSD +4.0 Hora de Verano de Moscú**
IRT +3.5 Hora de Irán*
IRST +4.5 Hora de Verano de Irán**
IST +5.5 Hora Estándar de la India
ICT +7.0 Hora de Indochina
KRAT +7.0 Hora de Krasnoyarsk*
KRAST +8.0 Horario de Verano de Krasnoyarsk**
CNST +8.0 Hora Estándar de China
ULAT +8.0 Hora de Ulán Bator
CIT +8.0 Hora Central de Indonesia
MYT +8.0 Hora de Malasia
SGT +8.0 Hora de Singapur
PHT +8.0 Hora de Filipinas
IRKT +8.0 Hora de Irkutsk*
IRKST +9.0 Hora de Verano de Irkutsk**
AWST +8.0 Hora Estándar de Australia Occidental
AWDT +9.0 Hora de Verano de Australia Occidental
JST +9.0 Hora Estándar de Japón
CHOT +9.0 Hora de Choibalsan
EIT +9.0 Hora de Indonesia Oriental
ACST +9.5 Hora Estándar de Australia Central*
ACDT +10.5 Hora de Verano de Australia Central**
AEST +10.0 Hora Estándar de Australia Oriental*
AEDT +11.0 Hora de Verano de Australia Oriental**
NFT +11.5 Hora de Norfolk
IDLE +12.0 Línea Internacional de Cambio de Fecha
NZST +12.0 Hora Estándar de Nueva Zelanda*
NZDT +13.0 Hora de Verano de Nueva Zelanda**

* La zona horaria tiene horario de verano/invierno

** Horario de Verano/Ahorro de Energía Diurna

wrapper.java.timezone

Compatibilidad :3.5.46
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Esta propiedad se puede utilizar para anular el valor de wrapper.timezone y configurar una zona horaria diferente para la aplicación Java. Se pueden utilizar los mismos valores de wrapper.timezone.

Esta propiedad tiene por defecto el valor de la propiedad wrapper.timezone.

Ejemplo:
wrapper.java.timezone=SYSTEM

A partir de Wrapper versión 3.5.50, cuando esta propiedad usa (o tiene como valor predeterminado) un valor con 'UTC', se pasa a la línea de comando usando la notación 'GMT' correspondiente para que sea compatible con Java.

Ejemplo:
wrapper.java.timezone=UTC+9
wrapper.java.command.loglevel=INFO
Ejemplo de salida de registro:
INFO   | 2022/05/11 10:11:10 | wrapper  |   Command: "C:\...\java.exe" ... -Duser.timezone=GMT+9 ...

NOTA

La zona horaria se pasa a la JVM agregando la propiedad del sistema 'user.timezone' a la línea de comandos de Java. Si la aplicación Java genera procesos hijo que usan la misma zona horaria, user.timezone también debe reenviarse a estos procesos.

ADVERTENCIA

El Wrapper establece su reloj interno utilizando la variable de entorno TZ. Antes de laversión 3.5.46, el proceso de Java, así como sus procesos secundarios, obtenían una copia del entorno con TZ configurado en la zona horaria del Wrapper. Sin embargo, cada vez que el Wrapper ajustaba la hora para los cambios de horario de verano, TZ se desincronizaba con los procesos de Java. A partir de la versión 3.5.46, el valor de TZ siempre se restaura a su valor original antes de iniciar la JVM.