$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 or EST.
  • 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.

Related Topics