blob: 1ce96f384d4dab965db8b5d8bbaf2acd140fef7a [file] [log] [blame]
.TH DATE 1
.SH NAME
date \- date and time
.SH SYNOPSIS
.B date
[
.I option
] [
.I seconds
]
.\" .br
.\" .B clock
.SH DESCRIPTION
Print the date, in the format
.PP
.B
Tue Aug 16 17:03:52 CDT 1977
.PP
The options are
.TP
.B -u
Report Greenwich Mean Time (GMT) rather than local time.
.TP
.B -n
Report the date as the number of seconds since the
epoch, 00:00:00 GMT, January 1, 1970.
.PP
The conversion from Greenwich Mean Time to local time depends on the
.B $timezone
environment variable; see
.IR ctime (3).
.PP
If the optional argument
.I seconds
is present, it is used as the time to convert rather than
the real time.
.\" .SH FILES
.\" .TF /adm/timezone/local
.\" .TP
.\" .B /env/timezone
.\" Current timezone name and adjustments.
.\" .TP
.\" .B /adm/timezone
.\" A directory containing timezone tables.
.\" .TP
.\" .B /adm/timezone/local
.\" Default timezone file, copied by
.\" .IR init (8)
.\" into
.\" .BR /env/timezone .
.\" .PD
.\" .PP
.\" .I Clock
.\" draws a simple analog clock in its window.
.SH SOURCE
.B \*9/src/cmd/date.c
.\" .br
.\" .B \*9/src/cmd/draw/clock.c