From 4ab8ea3cb729f7b99776ecf6e97a39755848892a Mon Sep 17 00:00:00 2001 From: Jim Meyering Date: Thu, 8 Apr 1999 13:44:19 +0000 Subject: [PATCH] (Options for date): Document --iso-8601 --- doc/sh-utils.texi | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/doc/sh-utils.texi b/doc/sh-utils.texi index 89758a2b8d..6973441ae0 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 -- 2.47.3