tznamecontains two strings, which are the standard names of the pair of time zones (standard and Daylight Saving) that the user has selected.
tznameis the name of the standard time zone (for example,
tznameis the name for the time zone when Daylight Saving Time is in use (for example,
"EDT"). These correspond to the std and dst strings (respectively) from the
TZenvironment variable. If Daylight Saving Time is never used,
tznameis the empty string.
tznamearray is initialized from the
TZenvironment variable whenever
localtimeis called. If multiple abbreviations have been used (e.g.
"EDT"for U.S. Eastern War Time and Eastern Daylight Time), the array contains the most recent abbreviation.
tznamearray is required for POSIX.1 compatibility, but in GNU programs it is better to use the
tm_zonemember of the broken-down time structure, since
tm_zonereports the correct abbreviation even when it is not the latest one.
Though the strings are declared as
char *the user must refrain from modifying these strings. Modifying the strings will almost certainly lead to trouble.
Preliminary: | MT-Safe env locale | AS-Unsafe heap lock | AC-Unsafe lock mem fd | See POSIX Safety Concepts.
tzsetfunction initializes the
tznamevariable from the value of the
TZenvironment variable. It is not usually necessary for your program to call this function, because it is called automatically when you use the other time conversion functions that depend on the time zone.
The following variables are defined for compatibility with System V
tzname, these variables are set by calling
tzset or the other time conversion functions.
This contains the difference between UTC and the latest local standard time, in seconds west of UTC. For example, in the U.S. Eastern time zone, the value is
5*60*60. Unlike the
tm_gmtoffmember of the broken-down time structure, this value is not adjusted for daylight saving, and its sign is reversed. In GNU programs it is better to use
tm_gmtoff, since it contains the correct offset even when it is not the latest one.