ctime64(3C)ctime64(3C)NAMEctime64(), ctime64_r(), difftime64(), gmtime64(), gmtime64_r(), local‐
time64(), localtime64_r(), mktime64() - convert date and time to string
SYNOPSISDESCRIPTION
Converts the calendar time pointed to by
timer, representing the time in seconds since the
Epoch, and return a pointer to the local time in the
form of a string. Equivalent to:
Is identical to except that it places the result in the user supplied
and returns a pointer to upon success. A buffer
length of at least 26 is required.
Returns the difference in seconds between two calendar times:
time1 - time0.
Converts directly to Coordinated Universal Time (UTC),
the time standard used by the HP-UX operating system.
returns a pointer to the structure.
Is identical to except that stores the result in the pointed to by
and returns upon success.
Corrects for the time zone and any summer time zone adjustments
(such as Daylight Savings Time in the USA), according
to the contents of the environment variable (see
below). returns a pointer to the structure.
Is identical to except that stores the result in the pointed to by
and returns upon success.
Converts the broken-down time (expressed as local time)
in the structure pointed to by timeptr into a calen‐
dar time value similar to but with an extended range.
The original values of the and components of the
structure are ignored, and the original values of the
other components are not restricted to the ranges
indicated below.
A positive or zero value for causes to initially pre‐
sume that Daylight Saving Time respectively is or is
not in effect for the specified time. A negative
value for causes to attempt to determine whether Day‐
light Saving Time is in effect for the specified
time.
Upon successful completion, all the components are
set to represent the specified calendar time, but
with their values forced to the ranges indicated
below. The final value of is not set until and are
determined. returns the specified calendar time
encoded as a value of type
The behavior of beyond the supported ranges is unde‐
fined.
The minimum and maximum dates supported by and are Friday December 13
20:45:52 UTC 1901 and Friday December 31 23:59:59 UTC 9999 respec‐
tively.
and returns NULL and sets errno to if timer is less than the number of
seconds that corresponds to the minimum date supported (in other words,
as defined in or exceeds the number of seconds that corresponds to the
maximum date supported.
For more details on (see ctime(3C)).
EXTERNAL INFLUENCES
Locale
The category determines the interpretation of the bytes within format
as single and/or multi-byte characters.
Environment Variables
The function uses the contents of to set the values of the external
variables and also determines the time zone name substituted for the
and directives and the time zone adjustments performed by and Two meth‐
ods for specifying a time zone within are described in environ(5).
International Code Set Support
Single and multibyte character code sets are supported.
RETURN VALUE
For if the buffer is of insufficient length, a NULL is returned and
errno set to
and return a NULL and set errno to if NULL pointers are passed in as
arguments.
A NULL is returned and errno is set to if the input to the following
routines is not within the supported range: and
APPLICATION USAGE
The return values for and point to static data whose contents is over‐
written by each call.
WARNINGS
The range of extends to 61 to allow for the occasional one or two leap
seconds. However, the "seconds since the Epoch" value returned by (see
time(2)) and passed as the timer argument does not include accumulated
leap seconds. The structure generated by and will never reflect any
leap seconds. Upon successful completion, forces the value of the com‐
ponent to the range [0,59].
AUTHOR
was developed by HP.
SEE ALSOtime(2), ctime(3C), setlocale(3C), tztab(4), environ(5), lang(5), lang‐
info(5), thread_safety(5).
ctime64(3C)