timezone(3C)       UNIX System V(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.






















10/89                                                                    Page 1