.th CTIME III 10/15/73
.sh NAME
ctime  \*-  convert date and time to ASCII
.sh SYNOPSIS
.ft B
char *ctime(tvec)
.br
int tvec[2];
.s3
.ft R
[from Fortran]
.br
.ft B
double precision ctime
.br
.li
... = ctime(dummy)
.s3
int *localtime(tvec)
.br
int tvec[2];
.s3
int *gmtime(tvec)
.br
int tvec[2];
.br
.ft R
.sh DESCRIPTION
.it Ctime
converts a time in the vector
.it tvec
such as returned by time (II)
into ASCII
and returns a pointer to a
character string
in the form
.s3
    Sun Sep 16 01:03:52 1973\\n\\0
.s3
All the fields have constant width.
.s3
Once the time has been placed into
.it t
and
.it t+2,
this routine is callable from assembly language
as follows:
.s3
.nf
.ft B
	mov	$t,\*-(sp)
	jsr	pc,\*_ctime
	tst	(sp)+
.s3
.ft R
.fi
and a pointer to the string is available in r0.
.s3
The
.it localtime
and
.it gmtime
entries return integer vectors to the broken-down time.
.it Localtime
corrects for the time zone and possible daylight savings time;
.it gmtime
converts directly to GMT, which is the time UNIX uses.
The value is a pointer
to an array whose components are
.s3
.lp +5 5
0	seconds
.lp +5 5
1	minutes
.lp +5 5
2	hours
.lp +5 5
3	day of the month (1-31)
.lp +5 5
4	month (0-11)
.lp +5 5
5	year \*- 1900
.lp +5 5
6	day of the week (Sunday = 0)
.lp +5 5
7	day of the year (0-365)
.lp +5 5
8	Daylight Saving Time flag if non-zero
.i0
.s3
The external variable
.it timezone
contains the difference, in seconds, between GMT and local
standard time (in EST, is 5*60*60);
the external variable
.it daylight
is non-zero iff the standard U.S.A. Daylight
Saving Time conversion should be applied
between the last Sundays in April and October.
The external variable
.it nixonflg
if non-zero
supersedes
.it daylight
and causes daylight time all year round.
.s3
A routine named
.it ctime
is also available from Fortran.
Actually it more resembles the
.it time
(II) system entry in that it returns the number of seconds
since the epoch
0000 GMT Jan. 1, 1970
(as a floating-point number).
.sh "SEE ALSO"
time(II)
.sh BUGS
