]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/date
games/galaxy: new mouse behavior
[plan9front.git] / sys / man / 1 / date
1 .TH DATE 1
2 .SH NAME
3 date, clock \- date and time
4 .SH SYNOPSIS
5 .B date
6 [
7 .I option
8 ] [
9 .I seconds
10 ]
11 .br
12 .B clock
13 .SH DESCRIPTION
14 Print the date, in the format
15 .PP
16 .B
17         Tue Aug 16 17:03:52 CDT 1977
18 .PP
19 The options are
20 .TP
21 .B -u
22 Report Greenwich Mean Time (GMT) rather than local time.
23 .TP
24 .B -n
25 Report the date as the number of seconds since the
26 epoch, 00:00:00 GMT, January 1, 1970.
27 .TP
28 .B -i
29 Report the date as ISO-8601 without time and timezone suffix.
30 .TP
31 .B -t
32 Report the date as ISO-8601 with time and timezone suffix.
33 .PP
34 The conversion from Greenwich Mean Time to local time depends on the
35 .B $timezone
36 environment variable; see
37 .IR ctime (2).
38 .PP
39 If the optional argument
40 .I seconds
41 is present, it is used as the time to convert rather than
42 the real time.
43 .PP
44 .I Clock
45 draws a simple analog clock in its window.
46 .SH FILES
47 .TF /adm/timezone/local
48 .TP
49 .B /env/timezone
50 Current timezone name and adjustments.
51 .TP
52 .B /adm/timezone
53 A directory containing timezone tables.
54 .TP
55 .B /adm/timezone/local
56 Default timezone file, copied by
57 .IR init (8)
58 into
59 .BR /env/timezone .
60 .PD
61 .SH SOURCE
62 .B /sys/src/cmd/date.c
63 .br
64 .B /sys/src/cmd/clock.c