CTIME(S) XENIX System V CTIME(S)
Name
ctime, localtime, gmtime, asctime, tzset - Converts date and
time to ASCII.
Syntax
char *ctime (clock)
long *clock;
#include <time.h>
#include <sys/types.h>
struct tm *localtime (clock)
long *clock;
struct tm *gmtime (clock)
long *clock;
char *asctime (tm)
struct tm *tm;
void tzset ( )
extern long timezone;
extern long altzone;
extern int daylight;
extern char *tzname[2];
Description
ctime converts a time pointed to by clock (such as returned
by time(S)) into ASCII and returns a pointer to a 26-
character string in the following form:
Sun Sep 16 01:03:52 1973\n\0
If necessary, fields in this string are padded with spaces
to keep the string a constant length.
localtime and gmtime return pointers to structures
containing the time as a variety of individual quantities.
These quantities give the time on a 24-hour clock, day of
month (1-31), month of year (0-11), day of week (Sunday =
0), year (since 1900), day of year (0-365), seconds from GMT
(East < 0), a flag that is nonzero if summer time (daylight
saving time) is in effect, and the name of the timezone.
localtime corrects for the time zone and possible summer
time. gmtime converts directly to Greenwich time (GMT),
which is the time the XENIX system uses.
asctime converts the times returned by localtime and gmtime
to a 26-character ASCII string and returns a pointer to this
string.
Page 1 (printed 8/7/87)
CTIME(S) XENIX System V CTIME(S)
The structure declaration for tm is defined in
/usr/include/time.h.
The external long variable timezone contains the difference,
in seconds, between GMT and local standard time (e.g., in
Eastern Standard Time (EST), timezone is 5*60*60);
similarly, the external long variable altzone contains the
difference, in seconds, between GMT and local summer time
(e.g., in Eastern Daylight Time (EDT), altzone is 4*60*60);
the external integer variable daylight is nonzero if and
only if summer time conversion should be applied.
If an environment variable named TZ is present, asctime uses
the contents of the variable to override the default time
zone as determined by ftime() (see time(S)). The value of
TZ is described in detail on the tz(M) manual page. The
effects of setting TZ are thus to change the values of the
external variables timezone, altzone, and daylight. In
addition, the time zone names contained in the external
variable
char *tzname[2] = {"EST", "EDT"};
are set from the environment variable. The rule for when to
change between standard time and summer time can be
specified in the TZ string. If a rule is not specified, the
standard U.S.A. Daylight Savings Time conversion is
applied. The program knows about the peculiarities of this
conversion in 1974 and 1975 and the change in 1987. The
function tzset sets the external variables from TZ ; it is
called by asctime and may also be called explicitly by the
user.
See Also
environ(M), getenv(S), time(S), tz(M)
Notes
The return values point to static data, whose content is
overwritten by each call.
Changes to TZ are immediately effective, (i.e. if a process
changes the TZ variable, the next call to a ctime(S) routine
returns a value based on the new value of the variable).
Page 2 (printed 8/7/87)