ctime64.3c (2010 09)

c
ctime64(3C) ctime64(3C)
NAME
ctime64(), ctime64_r(), difftime64(), gmtime64(), gmtime64_r(), localtime64(), localtime64_r(), mktime64()
- convert date and time to string
SYNOPSIS
#include <time64.h>
char *ctime64(const time64_t *timer);
char *ctime64_r(const time64_t *timer, char *buffer);
double difftime64(time64_t time1, time64_t time0);
struct tm *gmtime64(const time64_t *timer);
struct tm *gmtime64_r(const time64_t *timer, struct tm *result);
struct tm *localtime64(const time64_t *timer);
struct tm *localtime64_r(const time64_t *timer, struct tm *result);
time64_t mktime64(struct tm *timeptr);
DESCRIPTION
ctime64() 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:
asctime(localtime64(timer))
ctime64_r() Is identical to ctime64(), except that it places the result in the user supplied
buffer and returns a pointer to buffer upon success. A buffer length of at least 26
is required.
difftime64() Returns the difference in seconds between two calendar times: time1 - time0 .
gmtime64() Converts directly to Coordinated Universal Time (UTC), the time standard used by
the HP-UX operating system. gmtime64() returns a pointer to the tm structure.
gmtime64_r() Is identical to gmtime64(), except that gmtime64_r() stores the result in the
tm struct pointed to by result and returns result upon success.
localtime64() 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 TZ environment variable
(see Environment Variables below). localtime64()
returns a pointer to the tm
structure.
localtime64_r()
Is identical to localtime64()
, except that localtime64_r() stores the result
in the
tm struct pointed to by result and returns result upon success.
mktime64() Converts the broken-down time (expressed as local time) in the structure pointed to by
timeptr into a calendar time value with the same encoding as that of the values
returned by
time(). The original values of the tm_wday and tm_yday 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
tm_isdst causes mktime64() to initially presume that
Daylight Saving Time respectively is or is not in effect for the specified time. A nega-
tive value for tm_isdst causes mktime64() to attempt to determine whether
Daylight 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
tm_mday is not set until tm_mon and tm_year are determined.
mktime64() returns the specified calendar time encoded as a value of type
time64_t.
The behavior of
mktime64() beyond the supported ranges is undefined.
The minimum and maximum dates supported by
ctime64(), gmtime64(), localtime64(),
mktime64(), ctime64_r(), gmtime64_r(), and localtime64_r() are Friday December 13
20:45:52 UTC 1901 and Friday December 31 23:59:59 UTC 9999 respectively.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1