$NLS_TIME_ZONE
Specify the external time zone to use for returning, formatting, parsing, storing, retrieving, or exchanging date and time data.
$NLS_TIME_ZONE {
=
} TimeZone | classic
|
system
Arguments
- TimeZone—name of the time
zone as defined in the International Components for
Unicode (ICU). For example,
America/Detroit
orEST
. classic
—no time zone is specified. All date and time data is treated as being at the local time as specified on the executing system, and no time zone-based corrections are applied.system
—use the time zone as set on the local system; Windows only.
Defaults
Assignment file: | Application assignment file |
Section: | [SETTINGS] |
Default value: | classic , if omitted or not
specified |
Description
Setting the $nlstimezone ProcScript function overrides the value set by $NLS_TIME_ZONE in the assignment file (if defined).
Setting the value of $NLS_TIME_ZONE and/or $NLS_INTERNAL_TIME influences the date and time of values that are:
- Returned by the ProcScript functions $clock, $date, and $datim
- Displayed in fields with data types date, time, or combined date and time
- Stored and retrieved in the database
- Exchanged when using XML, call-in, or call-out
If $nlstimezone is set to a
specific time zone or to system
, time zone corrections, such as daylight savings
time, can be applied.
If $nlstimezone is set to
classic
, no time zone-related processing occurs. It is assumed that all times are
the local time. This is Uniface default behavior.
Note: Prior to Uniface 9.4, setting the Windows
environment variable TZ had no effect on the operating system date and time returned by Uniface.
Since the availability of $NLS_TIME_ZONE assignment setting and $nlstimezone ProcScript, the TZ value is taken into
consideration, even if the $NLS_TIME_ZONE is set to classic
. To
ensure that the date and time data used by Uniface is in sync with Windows, set
$NLS_TIME_ZONE to system
.