timezone(3C)         COMPATIBILITY FUNCTIONS         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  asso-
     ciated 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 suffi-
     cient 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 con-
     verted to a struct tm using localtime [see ctime(3)] and the
     tm_zone field of that structure should be used.  timezone is
     retained for compatibility with existing programs.























             Last change: BSD Compatibility Package             1