home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 16 Announce / 16-Announce.zip / tzvarbl.zip / TZ.txt < prev   
Text File  |  1996-10-16  |  7KB  |  92 lines
  1.  
  2.  This variable is used to describe the timezone information that the locale will use.  To set TZ, use the SET 
  3.  which has the following format: 
  4.  
  5.  ┌──────────────────────────────────────────────────────────────────────────────┐
  6.  │                                                                              │
  7.  │ >>──SET──TZ──=──SSS──┬──────────────────────────────┬──────────────────────> │ 
  8.  │                      └─┬───┬──h──┬────────────────┬─┘                        │
  9.  │                        ├─+─┤     └─:──m──┬──────┬─┘                          │
  10.  │                        └─┴─┘             └─:──s─┘                            │
  11.  │                                                                              │
  12.  │ >──┬─────────────────────────────────────────┬────────────────────────────>< │ 
  13.  │    └─DDD──┬────────────────────────────────┬─┘                               │ 
  14.  │           └─,sm,sw,sd,st,em,ew,ed,et,shift─┘                                 │ 
  15.  │                                                                              │
  16.  └──────────────────────────────────────────────────────────────────────────────┘
  17.  
  18.  The values for the TZ variable are defined below. The default values given are for the built-in "C" locale 
  19.  defined by the ANSI C standard. 
  20.  
  21.  ┌──────────────────────────────────────────────────────────────────────────────┐
  22.  │ Table 1. TZ Environment Variable Parameters                                  │
  23.  ├──────────────┬─────────────────────────────────────────────┬─────────────────┤
  24.  │ VARIABLE     │ DESCRIPTION                                 │ DEFAULT VALUE   │ 
  25.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  26.  │ SSS          │ Standard-timezone identifier.  It must be   │ EST             │ 
  27.  │              │ three characters, must begin with a letter, │                 │ 
  28.  │              │ and can contain spaces.                     │                 │ 
  29.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  30.  │ h, m, s      │ The variable h specifies the difference (in │ 5               │ 
  31.  │              │ hours) between the standard time zone and   │                 │ 
  32.  │              │ coordinated universal time (CUT), formerly  │                 │ 
  33.  │              │ Greenwich mean time (GMT).  You can         │                 │ 
  34.  │              │ optionally use m to specify minutes after   │                 │ 
  35.  │              │ the hour, and s to specify seconds after    │                 │ 
  36.  │              │ the minute.  A positive number denotes time │                 │ 
  37.  │              │ zones west of the Greenwich meridian; a     │                 │ 
  38.  │              │ negative number denotes time zones east of  │                 │ 
  39.  │              │ the Greenwich meridian.  The number must be │                 │ 
  40.  │              │ an integer value.                           │                 │ 
  41.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  42.  │ DDD          │ Daylight saving time (DST) zone identifier. │ EDT             │ 
  43.  │              │ It must be three characters, must begin     │                 │ 
  44.  │              │ with a letter, and can contain spaces.      │                 │ 
  45.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  46.  │ sm           │ Starting month (1 to 12) of DST.            │ 4               │ 
  47.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  48.  │ sw           │ Starting week (-4 to 4) of DST.  Use nega-  │ 1               │ 
  49.  │              │ tive numbers to count back from the last    │                 │ 
  50.  │              │ week of the month (-1) and positive numbers │                 │ 
  51.  │              │ to count from the first week (1).           │                 │ 
  52.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  53.  │ sd           │ Starting day of DST.                        │ 0               │ 
  54.  │              │ 0 to 6 if sw != 0                           │                 │ 
  55.  │              │ 1 to 31 if sw = 0                           │                 │ 
  56.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  57.  │ st           │ Starting time (in seconds) of DST.          │ 3600            │
  58.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  59.  │ em           │ Ending month (1 to 12) of DST.              │ 10              │
  60.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  61.  │ ew           │ Ending week (-4 to 4) of DST.  Use negative │ -1              │
  62.  │              │ numbers to count back from the last week of │                 │ 
  63.  │              │ the month (-1) and positive numbers to      │                 │ 
  64.  │              │ count from the first week (1).              │                 │ 
  65.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  66.  │ ed           │ Ending day of DST.                          │ 0               │ 
  67.  │              │ 0 to 6 if ew != 0                           │                 │ 
  68.  │              │ 1 to 31 if ew = 0                           │                 │ 
  69.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  70.  │ et           │ Ending time of DST (in seconds).            │ 7200            │
  71.  ├──────────────┼─────────────────────────────────────────────┼─────────────────┤
  72.  │ shift        │ Amount of time change (in seconds).         │ 3600            │
  73.  └──────────────┴─────────────────────────────────────────────┴─────────────────┘
  74.  
  75.  For example: 
  76.  
  77.     SET TZ=CST6CDT
  78.  
  79.  sets the standard time zone to CST, the daylight saving time zone to CDT, and sets a difference of 6 hours 
  80.  between CST and CUT. It does not set any values for the start and end date of daylight saving time or the time 
  81.  shifted. 
  82.  
  83.  When TZ is not present, the default is EST5EDT, the "C" locale value. When only the standard time zone is 
  84.  specified, the default value of n (difference in hours from GMT) is 0 instead of 5. 
  85.  
  86.  If you give values for any of sm, sw, sd, st, em, ew, ed, et, or shift, you must give values for all of them. the 
  87.  entire statement is considered not valid, and the time zone information is not changed. 
  88.  
  89.  The value of TZ can be accessed and changed by the tzset function. For more information on tzset, see the C 
  90.  Library Reference. 
  91.  
  92.