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


   NAME
         timezone - get time zone name given offset from GMT

   SYNOPSIS
         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.

   SEE ALSO
         ctime(3) in the Programmer's Reference Manual.

   NOTES
         The offset westward from Greenwich and an indication of whether
         Daylight Savings Time is in effect may not be sufficient to determine
         the name of the time zone, as the name may differ between different
         locations 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 converted to a struct tm using localtime [see ctime(3)] and
         the tmzone field of that structure should be used.  timezone is
         retained for compatibility with existing programs.




















   7/91                                                                 Page 1