Annotation of coherent/a/usr/man/MULTI/timezone, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: TIMEZONE              Environmental Variable             TIMEZONE
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Time zone information
                      9: 
                     10: TTIIMMEEZZOONNEE=_s_t_a_n_d_a_r_d:_o_f_f_s_e_t[:_d_a_y_l_i_g_h_t: _d_a_t_e:_d_a_t_e:_h_o_u_r:_m_i_n_u_t_e_s]
                     11: 
                     12: TIMEZONE  is an  environmental parameter  that  holds information
                     13: about  the  user's  time  zone.   This  information  is  used  by
                     14: COHERENT's time  routines to  construct their description  of the
                     15: current time and day.
                     16: 
                     17: To set the TIMEZONE parameter, use the sseett command, as follows:
                     18: 
                     19: 
                     20:         set TIMEZONE=[description]
                     21: 
                     22: 
                     23: where [description] is  the string that describes your time zone.
                     24: What this string consists of will be described below.  Most users
                     25: write this  command into the  file .pprrooffiillee, so  that TIMEZONE is
                     26: set automatically whenever they log onto the COHERENT system.
                     27: 
                     28: ***** The Description String *****
                     29: 
                     30: A TTIIMMEEZZOONNEE  description string consists of  seven fields that are
                     31: separated by  colons.  Fields  1 and 2  must be filled;  fields 3
                     32: through 7 are optional.
                     33: 
                     34: Field 1 gives the name of your standard time zone.  Field 2 gives
                     35: the  time zone's  offset  from Greenwich  Mean  Time in  minutes.
                     36: Offsets are  positive for time zones west  of Greenwich and nega-
                     37: tive for  time zones  east of  Greenwich.  For example,  users in
                     38: Chicago set these fields as follows:
                     39: 
                     40: 
                     41:         TIMEZONE=CST:360
                     42: 
                     43: 
                     44: CCSSTT  is an  abbreviation for Central  Standard Time,  that area's
                     45: time zone; and 360 refers to the fact that Chicago's time zone is
                     46: 360 minutes (six hours) behind that of Greenwich.
                     47: 
                     48: Field 3  gives the name  of the local daylight  saving time zone.
                     49: In Chicago, for example, this field would be set as follows:
                     50: 
                     51: 
                     52:         TIMEZONE=CST:360:CDT
                     53: 
                     54: 
                     55: CDT is an abbreviation for Central Daylight Time.  The absence of
                     56: this field indicates that  your area does not use daylight saving
                     57: time.
                     58: 
                     59: Fields 4  and 5 specify  the dates on which  daylight saving time
                     60: begins and ends.   If field 3 is set but  fields 4 and 5 are not,
                     61: changes between  standard time and  daylight saving time  are as-
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: TIMEZONE              Environmental Variable             TIMEZONE
                     70: 
                     71: 
                     72: 
                     73: sumed to occur at the times legislated in the United States: at 2
                     74: A.M. standard  time on the first  Sunday in April, and  at 2 A.M.
                     75: daylight saving time on the last Sunday in October.
                     76: 
                     77: Fields  4  and  5 each  consist  of  three  numbers separated  by
                     78: periods.  The first  number specifies which occurrence of the day
                     79: in the month marks the change, counting positive occurrences from
                     80: the beginning of the  month and negative occurrences from the the
                     81: end of the month.  The second number specifies a day of the week,
                     82: numbering Sunday  as one.  The third number  specifies a month of
                     83: the  year, numbering  January as  one.   For example,  in Chicago
                     84: fields 4 and 5 are set to the following:
                     85: 
                     86: 
                     87:         TIMEZONE=CST:360:CDT:1.1.4:-1.1.10
                     88: 
                     89: 
                     90: If the first number in either field is set to zero, then the last
                     91: two numbers  are assumed to  indicate an absolute  date.  This is
                     92: done because some countries switch to daylight saving time on the
                     93: same day each year, instead of a given day of the week.
                     94: 
                     95: Finally, fields  6 and  7 specify  the hour of  the day  at which
                     96: daylight saving  time begins and ends, and  the number of minutes
                     97: of adjustment.  In Chicago, these are set as follows:
                     98: 
                     99: 
                    100:         TIMEZONE=CST:360:CDT:1.1.4:-1.1.10:2:60
                    101: 
                    102: 
                    103: The `2' of field 6  indicates that the switch to daylight savings
                    104: time  occurs at  2 A.M.   The  ``60'' of  field 7  indicates that
                    105: daylight  savings time  changes  the local  time  by 60  minutes.
                    106: Although 60  minutes is the standard change,  some regions of the
                    107: world shift by 30, 45, 90, or 120 minutes; the last shift is also
                    108: called ``double daylight saving time''.
                    109: 
                    110: For an example of this variable's use in a program, see the entry
                    111: for asctime.
                    112: 
                    113: ***** See Also *****
                    114: 
                    115: environmental variables, setenv, time (overview)
                    116: 
                    117: For  those  requiring  more  information  on this  subject,  much
                    118: research has been  performed by astrologers.  See _T_i_m_e _C_h_a_n_g_e_s _i_n
                    119: _t_h_e  _W_o_r_l_d,  compiled   by  Doris  Chase  Doane  (three  volumes,
                    120: Hollywood, California, Professional Astrologers, Inc., 1970).
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.