.TH DATE 1
.SH NAME
date, clock, catclock \- date and time
.SH SYNOPSIS
.B date
[
.I option
] [
.I seconds
]
.br
.B clock
.br
.B games/catclock
[
.B -c
]
.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 (2).
.PP
If the optional argument
.I seconds
is present, it is used as the time to convert rather than
the real time.
.PP
.I Clock
draws a simple analog clock in its window.
.PP
.I Catclock
draws a simple Kit-Cat Klock in its window.
The
.B -c
option will cause the cat's eyes to come together and then go apart.
The default behavior is for the eyes to go in the same direction.
.SH SOURCE
.B /sys/src/cmd/date.c
.br
.B /sys/src/cmd/clock.c
.br
.B /sys/src/games/catclock.[cp]
.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
.SH BUGS
.IR Catclock 's
window cannot be too small, else clipping will occur.
.\" added games/catclock and fixed small location bug - pietro gagliardi - 3 jan 2008