DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
(BSD System Compatibility)

timezone(3bsd)


timezone -- (BSD) get time zone name given offset from GMT

Synopsis

   /usr/ucb/cc [flag . . . ] file . . .
   

char *timezone(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.

References

ctime(3C)

Notices

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(3C)] and the tm_zone field of that structure should be used. timezone is retained for compatibility with existing programs.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004