summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>1999-04-08 13:44:19 +0000
committerJim Meyering <jim@meyering.net>1999-04-08 13:44:19 +0000
commit4ab8ea3cb729f7b99776ecf6e97a39755848892a (patch)
tree8f9d4b5c092cfc94282e6e4ff7cda69a437b49d1 /doc
parent75e403b3b36c564eb914ebacd06ea815837d3867 (diff)
downloadcoreutils-4ab8ea3cb729f7b99776ecf6e97a39755848892a.tar.xz
(Options for date): Document --iso-8601
Diffstat (limited to 'doc')
-rw-r--r--doc/sh-utils.texi26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/sh-utils.texi b/doc/sh-utils.texi
index 89758a2b8..6973441ae 100644
--- a/doc/sh-utils.texi
+++ b/doc/sh-utils.texi
@@ -2390,6 +2390,32 @@ input. This is useful when you have many dates to process, because the
system overhead of starting up the @code{date} executable many times can
be considerable.
+@item -I[@var{timespec}]
+@itemx --iso-8601[=@var{timespec}]
+@opindex -I[@var{timespec}]
+@opindex --iso-8601[=@var{timespec}]
+Display the date using the ISO 8601 format, @samp{%Y-%m-%d}.
+
+The optional argument @var{timespec} specifies the number of additional
+terms of the time to include. It can be one of the following:
+@table @samp
+@item auto
+The default behavior: print just the date.
+
+@item hours
+Append the hour of the day to the date.
+
+@item minutes
+Append the hours and minutes.
+
+@item seconds
+Append the hours, minutes, and seconds.
+@end table
+
+If showing any time terms, then include the time zone using the format
+@samp{%z}. If @samp{--utc} is also specified, use @samp{%Z} in place of
+@samp{%z}.
+
@item -R
@itemx --rfc-822
@opindex -R