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 -unitm
   8 ] [
   9 .B -f
  10 .I format
  11 ] [
  12 .I seconds
  13 ]
  14 .br
  15 .B clock
  16 .SH DESCRIPTION
  17 Print the date, in the format
  18 .PP
  19 .B
  20         Tue Aug 16 17:03:52 CDT 1977
  21 .PP
  22 Or the format specified by the format option.
  23
  24 The options are
  25 .TP
  26 .B -u
  27 Report Greenwich Mean Time (GMT) rather than local time.
  28 .TP
  29 .B -n
  30 Report the date as the number of seconds since the
  31 epoch, 00:00:00 GMT, January 1, 1970.
  32 .TP
  33 .B -i
  34 Report the date as ISO-8601 without time and timezone suffix.
  35 .TP
  36 .B -t
  37 Report the date as ISO-8601 with time and timezone suffix.
  38 .TP
  39 .B -m
  40 Report the date as an email compatible (RFC2822) time stamp.
  41 .TP
  42 .B -f
  43 Print using the format specified by the
  44 .I format
  45 string rather than the default. Format strings are in the format used by
  46 .IR tmdate (2)
  47
  48 .PP
  49 The conversion from Greenwich Mean Time to local time depends on the
  50 .B $timezone
  51 environment variable; see
  52 .IR ctime (2).
  53 .PP
  54 If the optional argument
  55 .I seconds
  56 is present, it is used as the time to convert rather than
  57 the real time.
  58 .PP
  59 .I Clock
  60 draws a simple analog clock in its window.
  61 .SH FILES
  62 .TF /adm/timezone/local
  63 .TP
  64 .B /env/timezone
  65 Current timezone name and adjustments.
  66 .TP
  67 .B /adm/timezone
  68 A directory containing timezone tables.
  69 .TP
  70 .B /adm/timezone/local
  71 Default timezone file, copied by
  72 .IR init (8)
  73 into
  74 .BR /env/timezone .
  75 .PD
  76 .SH SOURCE
  77 .B /sys/src/cmd/date.c
  78 .br
  79 .B /sys/src/cmd/clock.c
  80 .SH "SEE ALSO"
  81 .IR tmdate (2)