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