MPE/iX Shell and Utilities Reference Manual, Vol 2
timezone(3) MPE/iX Shell and Utilities timezone(3)
NAME
timezone — setting local time zone
SYNOPSIS
TZ
=standardHH[:MM[:SS]][daylight[offset][,startdate[starttime],
enddate[endtime]]]
DESCRIPTION
The time kept by the local machine should be a universal standard representation such as
Greenwich Mean Time (GMT) or Universal Time Coordinated (UTC) — hereafter referred to as
the universal reference time. For personal computers that are not sharing data across time
zones, the local time is an adequate standard. To support a universal standard, all MPE/iX utili-
ties assume that times stored in the file system and returned by the operating system are stored
in the universal reference time, then translated to local times. The mapping from the universal
reference time to local time is specified by the
TZ
(time zone) environment variable.
The value of the
TZ
variable has the following five fields — two required and three optional:
standard
An alphabetic abbreviation for the local standard time zone (for example, GMT
, EST,
MSEZ).
HH[:MM[:SS]]
The time offset westwards from the universal reference time. A leading dash
(–) means that the local time zone is east of the universal reference time. An option-
al colon (:) separates hours from optional minutes and seconds.
[daylight]
The abbreviation for your local daylight savings time zone. If the first and third fields
are identical or third field is missing, Daylight Saving Time conversion is disabled.
[offset] The number of hours, minutes, and seconds your local Daylight Savings Time is off-
set from
UTC when Daylight Savings Time is in effect. If the Daylight Savings Time
abbreviation is specified, and the offset omitted, the offset of one hour is assumed.
[,startdate[/starttime],enddate[/endtime]]
A rule which identifies the start and end of Daylight Savings Time — specifying
when Daylight Savings Time should be in effect. Both the startdate and enddate
must be present, and must either take the form Jn, n,or Mm.n.d..
• Jn is the Julian day n (1 <= n <= 365) and does not account for leap days.
• n is the zero-based Julian day (0 <= n <= 365). Leap days are counted; therefore,
you may refer to February 29th.
Miscellaneous Information 3-51