BSD 4_4 release
[unix-history] / usr / src / share / man / man3f / time.3
CommitLineData
7e0234f9
KB
1.\" Copyright (c) 1983, 1993
2.\" The Regents of the University of California. All rights reserved.
e7fd7fad 3.\"
ad787160
C
4.\" This module is believed to contain source code proprietary to AT&T.
5.\" Use and redistribution is subject to the Berkeley Software License
6.\" Agreement and your Software Agreement with AT&T (Western Electric).
ecee498b 7.\"
ad787160 8.\" @(#)time.3 8.1 (Berkeley) 6/5/93
e7fd7fad 9.\"
ad787160 10.TH TIME 3F "June 5, 1993"
e7fd7fad
KM
11.UC 5
12.SH NAME
13time, ctime, ltime, gmtime \- return system time
14.SH SYNOPSIS
15.B integer function time()
16.sp 1
17.B character*(*) function ctime (stime)
18.br
19.B integer stime
20.sp 1
21.B subroutine ltime (stime, tarray)
22.br
23.B integer stime, tarray(9)
24.sp 1
25.B subroutine gmtime (stime, tarray)
26.br
27.B integer stime, tarray(9)
28.SH DESCRIPTION
29.I Time
30returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds.
31This is the value of the UNIX system clock.
32.PP
33.I Ctime
34converts a system time to a 24 character ASCII string.
35The format is described under
36.IR ctime (3).
37No 'newline' or NULL will be included.
38.PP
39.I Ltime
40and
41.I gmtime
42disect a UNIX time into month, day, etc., either for the local time zone
43or as GMT.
44The order and meaning of each element returned in
45.I tarray
46is described under
47.IR ctime (3).
48.SH FILES
49.ie \nM /usr/ucb/lib/libU77.a
50.el /usr/lib/libU77.a
51.SH "SEE ALSO"
52ctime(3), itime(3F), idate(3F), fdate(3F)