World Map
Java Service Wrapper is the easiest way to make your product more reliable.
  • Free Trial
  • Buy Now
wrapper.timezone Property

wrapper.timezone

Compatibility :3.3.6
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

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 and a 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.

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.

Examples on defining the Timezone:
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

Changing the timezone will affect the timestamps in all log output (in Standard and Professional Editions), as well as the wrapper.timer.<n>.interval property and the Mail Settings (in Professional Edition).

wrapper.timezone.folder

Compatibility :3.5.29
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

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 availabe on Oracle's website.

wrapper.timezone.use_summer_time

Compatibility :3.3.7
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

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".

Example: (Enable the time change to Summer/Winter Time)
wrapper.timezone.use_summer_time=TRUE

NOTE

If a timezone doesn't use Summer Time, this property will be ignored. This also means that the Wrapper won't respect the property if the timezone was defined with "UTC+/-xxxx". Also when a Summer (Daylight) Time has been defined for wrapper.timezone, this property also has no effect.

wrapper.timezone.debug_timestamps

Compatibility :3.5.30
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

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.

Example: (log output with wrapper.timezone.debug_timestamps=TRUE)
STATUS | 2016/03/16 17:54:44 GMT-07:00 D | wrapper  | --> Wrapper Started as Console

List of the supported timezone identifiers

IANA timezones

For a full list of the IANA timezone identifiers please refer to this page.

Time zone abbreviations (deprecated)

NameOffset to UTC0 in hoursDescription
IDLW -12.0 International Date Line West
HAST -10.0 Hawaii Standard Time*
HDT -9.0 Hawaii Daylight Time**
AKST -9.0 Alaska Standard Time*
AKDT -8.0 Alaska Daylight Time**
YST -9.0 Yukon Standard Time*
YDT -8.0 Yukon Daylight Time**
PST -8.0 Pacific Standard Time*
PT -8.0 Pacific Time*
PDT -7.0 Pacific Daylight Time**
MST -7.0 Mountain Standard Time*
MDT -6.0 Mountain Daylight Time**
CST -6.0 Central Standard Time*
CDT -5.0 Central Daylight Time**
EST -5.0 Eastern Standard Time*
VST -4.5 Venezuelan Standard Time
EDT -4.0 Eastern Daylight Time**
AST -4.0 Atlantic Standard Time*
ADT -3.0 Atlantic Daylight Time**
NST -3.5 Newfoundland Standard Time*
NDT -2.5 Newfoundland Daylight Time**
GMT 0 Greenwich Mean Time*
WET 0 West European Time*
WEST +1.0 West European Summer Time**
WEDT +1.0 West European Daylight Time**
BST +1.0 British Summer Time**
WAT +1.0 West African Time
CET +1.0 Central European Time*
CEST +2.0 Central European Summer Time**
CEDT +2.0 Central European Daylight Time**
EET +2.0 East European Time*
EEST +3.0 East European Summer Time**
EAT +3.0 East African Time
BT +3.0 Bagdad Time
MSK +3.0 Moscow Time*
MSD +4.0 Moscow Daylight Time**
IRT +3.5 Iran Time*
IRST +4.5 Iran Summer Time**
IST +5.5 Indian Standard Time
ICT +7.0 Indochina Time
KRAT +7.0 Krasnoyarsk Time*
KRAST +8.0 Krasnoyarsk Summer Time**
CNST +8.0 China Standard Time
ULAT +8.0 Ulaanbaatar Time
CIT +8.0 Central Indonesian Time
MYT +8.0 Malaysian Time
SGT +8.0 Singapore Time
PHT +8.0 Philippine Time
IRKT +8.0 Irkutsk Time*
IRKST +9.0 Irkutsk Summer Time**
AWST +8.0 Australian West Standard Time
AWDT +9.0 Australian West Daylight Time
JST +9.0 Japan Standard Time
CHOT +9.0 Choibalsan Time
EIT +9.0 East Indonesian Time
ACST +9.5 Australian Central Standard Time*
ACDT +10.5 Australian Central Daylight Time**
AEST +10.0 Australian East Standard Time*
AEDT +11.0 Australian East Daylight Time**
NFT +11.5 Norfolk Time
IDLE +12.0 International Date Line East
NZST +12.0 New Zealand Standard Time*
NZDT +13.0 New Zealand Daylight Time**

* Timezone has a summer/winter time

** Summer/Daylight Savings time