timezone(3C)            (BSD Compatibility Package)            timezone(3C)

NAME
     timezone - get time zone name given offset from GMT

SYNOPSIS
     /usr/ucb/cc [flag ...] file ... -lucb

     char *timezone(zone, dst)
     int zone;
     int dst;

DESCRIPTION
     timezone attempts to return the name of the time zone associated with
     its first argument, which is measured in minutes westward from
     Greenwich. If the second argument is 0, the standard name is used,
     otherwise the Daylight Savings Time version. If the required name does
     not appear in a table built into the routine, the difference from GMT
     is produced; for instance, in Afghanistan timezone(-(60*4+30), 0) is
     appropriate because it is 4:30 ahead of GMT and the string GMT+4:30 is
     produced.

NOTES
     The offset westward from Greenwich and an indication of whether Day-
     light Savings Time is in effect may not be sufficient to determine the
     name of the time zone, as the name may differ between different loca-
     tions in the same time zone. Instead of using timezone to determine
     the name of the time zone for a given time, that time should be con-
     verted to a struct tm using localtime and the tmzone field of that
     structure should be used. timezone is retained for compatibility with
     existing programs.

SEE ALSO
     ctime(3C).























Page 1                       Reliant UNIX 5.44                Printed 11/98