HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

c
ctime(3C) ctime(3C)
The file /etc/default/tz
contains the timezone value used by
tzset() when the
environment variable
TZ is not set. The format for the file is same as
TZ format
without the prefix
TZ=. Please check environ(5) for
TZ format. The order of TZ setting
is as follows.
1) if the environment variable
TZ
is present, it takes precedence.
2) if
TZ is not present, then the value contained in
/etc/default/tz
is used for
the default.
3) if
/etc/default/tz
is not set then the default value is equivalent to
EST5EDT
(Eastern Standard Time) of the USA.
/etc/default/tz
can be modified for an appropriate default value for timezone.
The <
time.h> header file contains declarations of all relevant functions and externals. It also contains
the tm structure, which includes the following members:
int tm_sec; /* seconds after the minute - [0,61] */
int tm_min; /* minutes after the hour - [0,59] */
int tm_hour; /* hours - [0,23] */
int tm_mday; /* day of month - [1,31] */
int tm_mon; /* month of year - [0,11] */
int tm_year; /* years since 1900 */
int tm_wday; /* days since Sunday - [0,6] */
int tm_yday; /* days since January 1 - [0,365] */
int tm_isdst; /* daylight savings time flag */
The value of tm_isdst is positive if a summer time zone adjustment such as Daylight Savings Time is in
effect, zero if not in effect, and negative if the information is not available.
The external variable timezone contains the difference, in seconds, between UTC and local standard
time (for example, in the U.S. Eastern time zone (EST), timezone is 5∗60∗60). The external variable
daylight is non-zero only if a summer time zone adjustment is specified in the TZ environment variable.
The external variable tzname[2] contains the local standard and local summer time zone abbreviations
as specified by the TZ environment variable.
EXTERNAL INFLUENCES
Locale
The LC_CTYPE category determines the interpretation of the bytes within format as single and/or multi-
byte characters.
Environment Variables
The
tzset() function uses the contents of TZ to set the values of the external variables
timezone,
daylight, and tzname. TZ also determines the time zone name substituted for the %Z
and %z direc-
tives and the time zone adjustments performed by
localtime() , mktime(), and ctime().Two
methods for specifying a time zone within
TZ are described in environ(5).
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
For asctime_r() and ctime_r(), if the buffer is of insufficient length, a NULL is returned and errno
set to [EINVAL].
asctime_r() , ctime_r(), gmtime_r() , and localtime_r() return a NULL and set errno to
[EINVAL] if NULL pointers are passed in as arguments.
A NULL is returned and errno is set to [ERANGE] if the input to the following routines is not within the
supported range: asctime(), asctime_r() , ctime(), ctime_r(), gmtime(), gmtime_r() ,
localtime() , localtime_r().
APPLICATION USAGE
The return values for asctime() , ctime(), gmtime(), and localtime() point to static data
whose contents is overwritten by each call.
248 Hewlett-Packard Company − 3 − HP-UX 11i Version 2: December 2007 Update