wrapper.timezone

Compatibilité :3.3.6
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

La propriété timezone permet de définir le fuseau horaire dans lequel le Wrapper sera exécuté.

À partir de la version 3.5.29, il est conseillé d'utiliser les identifiants de fuseau horaire IANA. Ces identifiants sont composés du nom d'un continent ou d'un océan, suivi d'une barre oblique et du nom d'un lieu représentatif de cette zone (généralement le nom de la plus grande ville). Par exemple, 'America/Los_Angeles' représente le fuseau horaire de l'heure du Pacifique. Une liste complète des identifiants se trouve ici.

Les autres valeurs possibles sont 'UTC', éventuellement suivi de '+(-)hhmm', pour spécifier le décalage par rapport au Temps universel coordonné, ou 'SYSTEM' (3.5.46) pour spécifier le fuseau horaire local du système sur lequel le Wrapper s'exécute.

Pour des raisons de rétrocompatibilité, une liste d'abréviations de fuseau horaire (par ex. MST, GMT, JST, etc.) est également prise en charge. Cependant, Java les a dépréciées car la même abréviation est parfois utilisée pour représenter plusieurs fuseaux horaires. Il n'est pas recommandé de les utiliser dans la configuration du Wrapper, car le même code peut conduire à des interprétations différentes selon le système d'exploitation.

Avec les fuseaux horaires IANA, la même configuration produira toujours la même heure, quelle que soit la plateforme.

Exemples de définition du fuseau horaire :
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) 

NOTE

La modification du fuseau horaire affectera les horodatages dans toutes les sorties de journal (dans les éditions Standard et Professional), ainsi que la propriété wrapper.timer.<n>.interval et les paramètres de messagerie (dans l'édition Professional).

À partir de la version 3.5.35, le fuseau horaire, s'il est spécifié, sera transmis à la JVM via l'option 'user.timezone'. Cela garantit que l'heure est synchronisée entre le Wrapper et l'application Java.

Il est possible de spécifier un fuseau horaire différent pour l'application Java en définissant la propriété wrapper.java.timezone.

wrapper.timezone.folder

Compatibilité :3.5.29
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété est requise lors de l'utilisation d'un identifiant IANA. Elle permet de spécifier le chemin vers un répertoire contenant les fichiers sources de la base de données des fuseaux horaires IANA.

La base de données des fuseaux horaires IANA est régulièrement mise à jour pour prendre en compte les changements d'heure locale dans le monde entier. La base de données fournit plusieurs fichiers (un par région du monde) regroupés dans un seul package tar.gz, disponibles au téléchargement sur le site de l'Internet Assigned Number Authority (IANA).

Ces fichiers sont nommés :

  • africa

  • asia

  • australasia

  • europe

  • northamerica

  • southamerica

Vous devez sélectionner le fichier nommé d'après la région contenant le fuseau horaire choisi. Par exemple, le fichier 'northamerica' serait utilisé pour le fuseau horaire 'America/Los_Angeles'. Ensuite, extrayez-le et placez-le à l'emplacement spécifié par la propriété wrapper.timezone.file. Vous pouvez également placer d'autres fichiers dans le même dossier si vous prévoyez de changer wrapper.timezone pour un fuseau horaire situé dans une autre région.

Comme Java utilise également la base de données des fuseaux horaires IANA, l'heure utilisée par votre application Java sera cohérente avec celle du Wrapper tant qu'ils utilisent le même identifiant de fuseau horaire. Cependant, vous devrez peut-être vérifier que la version de la base de données des fuseaux horaires est identique à celle fournie dans votre version de JRE. Une liste des versions par version de JRE est disponible sur le site d'Oracle.

AVERTISSEMENT

Jusqu'à la version 3.5.44, il y avait un problème où le Wrapper se bloquait au démarrage si le fichier 'etcetera' (faisant partie de la base de données tz IANA) était présent à l'emplacement spécifié par wrapper.timezone.folder. La suppression de ce fichier permettait de résoudre le problème. Ceci a été corrigé dans la version 3.5.45.

wrapper.timezone.use_summer_time

Compatibilité :3.3.7
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Parfois, vous souhaitez désactiver l'heure d'été pour certaines raisons, comme faire fonctionner le Wrapper sur différents serveurs dans différents fuseaux horaires tout en conservant les fichiers journaux avec les mêmes horodatages, sans modifier le fuseau horaire du système. Avec cette propriété, vous pouvez spécifier si le Wrapper modifiera automatiquement les informations de fuseau horaire pour passer à l'heure d'été/d'hiver, si la propriété wrapper.timezone a été définie.

La valeur par défaut est "TRUE".

Exemple : (Activer le changement d'heure d'été/d'hiver)
wrapper.timezone.use_summer_time=TRUE

NOTE

Si un fuseau horaire n'utilise pas l'heure d'été, cette propriété sera ignorée. Cela signifie également que le Wrapper ne respectera pas la propriété si le fuseau horaire a été défini avec "UTC+/-xxxx". De même, lorsqu'une heure d'été a été définie pour wrapper.timezone, cette propriété n'a aucun effet.

wrapper.timezone.debug_timestamps

Compatibilité :3.5.30
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété permet d'afficher le décalage du fuseau horaire actuel dans les horodatages des sorties de journal. Lors de l'utilisation d'un fuseau horaire IANA, une lettre supplémentaire sera ajoutée pour indiquer si l'heure d'été est en vigueur ('D' pour l'heure d'été, 'S' pour l'heure d'hiver).

La valeur par défaut est FALSE, ce qui signifie que les horodatages seront affichés sans cette information supplémentaire.

Exemple : (sortie de journal avec wrapper.timezone.debug_timestamps=TRUE)
STATUS | 2016/03/16 17:54:44 GMT-07:00 D | wrapper  | --> Wrapper Started as Console

Liste des identifiants de fuseau horaire pris en charge

Fuseaux horaires IANA

Pour une liste complète des identifiants de fuseau horaire IANA, veuillez consulter cette page.

Abréviations de fuseau horaire (dépréciées)

NameOffset to UTC0 in hoursDescription
IDLW -12.0 Ligne internationale de changement de date Ouest
HAST -10.0 Heure standard d'Hawaï*
HDT -9.0 Heure d'été d'Hawaï**
AKST -9.0 Heure standard de l'Alaska*
AKDT -8.0 Heure d'été de l'Alaska**
YST -9.0 Heure standard du Yukon*
YDT -8.0 Heure d'été du Yukon**
PST -8.0 Heure standard du Pacifique*
PT -8.0 Heure du Pacifique*
PDT -7.0 Heure d'été du Pacifique**
MST -7.0 Heure standard des Rocheuses*
MDT -6.0 Heure d'été des Rocheuses**
CST -6.0 Heure standard du Centre*
CDT -5.0 Heure d'été du Centre**
EST -5.0 Heure standard de l'Est*
VST -4.5 Heure standard du Venezuela
EDT -4.0 Heure d'été de l'Est**
AST -4.0 Heure standard de l'Atlantique*
ADT -3.0 Heure d'été de l'Atlantique**
NST -3.5 Heure standard de Terre-Neuve*
NDT -2.5 Heure d'été de Terre-Neuve**
GMT 0 Heure moyenne de Greenwich*
WET 0 Heure d'Europe de l'Ouest*
WEST +1.0 Heure d'été d'Europe de l'Ouest**
WEDT +1.0 Heure d'été d'Europe de l'Ouest**
BST +1.0 Heure d'été britannique**
WAT +1.0 Heure d'Afrique de l'Ouest
CET +1.0 Heure d'Europe centrale*
CEST +2.0 Heure d'été d'Europe centrale**
CEDT +2.0 Heure d'été d'Europe centrale**
EET +2.0 Heure d'Europe de l'Est*
EEST +3.0 Heure d'été d'Europe de l'Est**
EAT +3.0 Heure d'Afrique de l'Est
BT +3.0 Heure de Bagdad
MSK +3.0 Heure de Moscou*
MSD +4.0 Heure d'été de Moscou**
IRT +3.5 Heure de l'Iran*
IRST +4.5 Heure d'été de l'Iran**
IST +5.5 Heure standard de l'Inde
ICT +7.0 Heure d'Indochine
KRAT +7.0 Heure de Krasnoïarsk*
KRAST +8.0 Heure d'été de Krasnoïarsk**
CNST +8.0 Heure standard de Chine
ULAT +8.0 Heure d'Oulan-Bator
CIT +8.0 Heure d'Indonésie centrale
MYT +8.0 Heure de Malaisie
SGT +8.0 Heure de Singapour
PHT +8.0 Heure des Philippines
IRKT +8.0 Heure d'Irkoutsk*
IRKST +9.0 Heure d'été d'Irkoutsk**
AWST +8.0 Heure standard de l'ouest de l'Australie
AWDT +9.0 Heure d'été de l'ouest de l'Australie
JST +9.0 Heure standard du Japon
CHOT +9.0 Heure de Choibalsan
EIT +9.0 Heure d'Indonésie de l'Est
ACST +9.5 Heure standard du centre de l'Australie*
ACDT +10.5 Heure d'été du centre de l'Australie**
AEST +10.0 Heure standard de l'est de l'Australie*
AEDT +11.0 Heure d'été de l'est de l'Australie**
NFT +11.5 Heure de Norfolk
IDLE +12.0 Ligne internationale de changement de date Est
NZST +12.0 Heure standard de Nouvelle-Zélande*
NZDT +13.0 Heure d'été de Nouvelle-Zélande**

* Le fuseau horaire a une heure d'été/d'hiver

** Heure d'été

wrapper.java.timezone

Compatibilité :3.5.46
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété peut être utilisée pour remplacer la valeur de wrapper.timezone et configurer un fuseau horaire différent pour l'application Java. Les mêmes valeurs que wrapper.timezone peuvent être utilisées.

Cette propriété prend par défaut la valeur de la propriété wrapper.timezone.

Exemple :
wrapper.java.timezone=SYSTEM

À partir de la version 3.5.50 du Wrapper, lorsque wrapper.java.timezone utilise (ou prend par défaut) une valeur avec 'UTC', celle-ci est transmise à la ligne de commande en utilisant la notation 'GMT' correspondante afin d'être compatible avec Java.

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

NOTE

Le fuseau horaire est transmis à la JVM en ajoutant la propriété système 'user.timezone' à la ligne de commande Java. Si l'application Java lance des processus enfants qui utilisent le même fuseau horaire, user.timezone doit également être transmise à ces processus.

AVERTISSEMENT

Le Wrapper règle son horloge interne en utilisant la variable d'environnement TZ. Avant la version 3.5.46, le processus Java, ainsi que ses processus enfants, recevaient une copie de l'environnement avec TZ définie sur le fuseau horaire du Wrapper. Cependant, chaque fois que le Wrapper ajustait l'heure pour les changements d'heure d'été, TZ se désynchronisait avec le(s) processus Java. À partir de la version 3.5.46, la valeur de TZ est toujours restaurée à sa valeur d'origine avant le lancement de la JVM.