Compatibility :	3.3.6
Editions :
Platforms :

The timezone property makes it possible to define the time zone in which the Wrapper will be executed.

Starting from version 3.5.29, it is advised to use IANA time zone identifiers. These identifiers are composed of the name of a continent or ocean followed by a slash and the name of a representative location within this area (typically the name of the largest city). For example, 'America/Los_Angeles' represents the timezone of Pacific Time. A full list of the identifiers can be found here.

Other possible values are 'UTC', optionally followed by '+(-)hhmm', to specify the offset to the Coordinated Universal Time, or 'SYSTEM' (3.5.46) to specify the local time zone of the system on which the Wrapper is running.

For backward compatibility, a list of time zone abbreviations (e.g. MST, GMT, JST, etc.) is also supported. However, Java deprecated these because the same abbreviation is sometimes used to represent several time zones. It is not recommended to use them in the Wrapper configuration because the same code may lead to different interpretations depending on the operating system.

With IANA time zones, the same configuration will always produce the same time regardless of the platform.

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) 

Compatibility :	3.5.29
Editions :
Platforms :

This property is required when using an IANA identifier. It allows you to specify the path to a directory containing the IANA Time Zone Database source files.

The IANA Time Zone database is regularly updated to take into account changes in the local times all over the world. The database provides several files (one per region in the world) which are grouped together in a single tar.gz package, and available for download on the website of the Internet Assigned Number Authority (IANA).

These files are called:

• africa

• asia

• australasia

• europe

• northamerica

• southamerica

You should select the file named with the region containing the selected timezone. For example, the file 'northamerica' would be used when using the time zone 'America/Los_Angeles'. Next, extract it and put it in the location specified by the wrapper.timezone.file property. You may also put other files in the same folder if you plan to change wrapper.timezone to a timezone located in another region.

Since Java also uses the IANA Time Zone Database, the time used by your Java application will be consistent with the time of the Wrapper as long as they use the same timezone identifier. However, you may have to confirm that the version of the timezone database is the same as the one provided in your JRE release. A list of the versions per JRE release is available on Oracle's website.

Compatibility :	3.3.7
Editions :
Platforms :

Sometimes you want to turn off Summer (Daylight Saving) Time for some reasons like having the Wrapper run on different servers in different timezones and keeping the log files with the same timestamps, without changing the system's timezone. With this property, you can specify whether the Wrapper will change the timezone information to Summer(Daylight)/Winter Time automatically, if the wrapper.timezone property has been set.

The default value is "TRUE".

wrapper.timezone.use_summer_time=TRUE

Compatibility :	3.5.30
Editions :
Platforms :

This property allows to display the offset of the current timezone in the timestamps of the log outputs. When using a IANA timezone, an additional letter will be added to indicate if daylight saving time is in effect ('D' for Daylight saving time, 'S' for Standard time).

The default value is FALSE, meaning that the timestamps will be displayed without this additional information.

STATUS | 2016/03/16 17:54:44 GMT-07:00 D | wrapper  | --> Wrapper Started as Console

Compatibility :	3.5.46
Editions :
Platforms :

This property can be used to override the value of wrapper.timezone and configure a different timezone for the Java application. The same values as wrapper.timezone can be used.

This property defaults to the value of the wrapper.timezone property.

wrapper.java.timezone=SYSTEM

As of Wrapper version 3.5.50, when wrapper.java.timezone uses (or defaults to) a value with 'UTC', it is passed to the command line using the corresponding 'GMT' notation to be compatible with Java.

wrapper.java.timezone=UTC+9
wrapper.java.command.loglevel=INFO

INFO   | 2022/05/11 10:11:10 | wrapper  |   Command: "C:\...\java.exe" ... -Duser.timezone=GMT+9 ...