GNU Info

(sh-utils.info)Options for date

---

Next: Examples of date Prev: Setting the time Up: date invocation

---

Enter node , (file) or (file)node

Options for `date'
------------------

   The program accepts the following options.  Also see Note: Common
options.

`-d DATESTR'
`--date=DATESTR'
     Display the time and date specified in DATESTR instead of the
     current time and date.  DATESTR can be in almost any common
     format.  It can contain month names, timezones, `am' and `pm',
     `yesterday', `ago', `next', etc.  Note: Date input formats.

`-f DATEFILE'
`--file=DATEFILE'
     Parse each line in DATEFILE as with `-d' and display the resulting
     time and date.  If DATEFILE is `-', use standard input.  This is
     useful when you have many dates to process, because the system
     overhead of starting up the `date' executable many times can be
     considerable.

`-I[TIMESPEC]'
`--iso-8601[=TIMESPEC]'
     Display the date using the ISO 8601 format, `%Y-%m-%d'.

     The optional argument TIMESPEC specifies the number of additional
     terms of the time to include.  It can be one of the following:
    `auto'
          The default behavior: print just the date.

    `hours'
          Append the hour of the day to the date.

    `minutes'
          Append the hours and minutes.

    `seconds'
          Append the hours, minutes, and seconds.

     If showing any time terms, then include the time zone using the
     format `%z'.

`-R'
`--rfc-822'
     Display the time and date using the RFC-822-conforming format,
     `%a, %_d %b %Y %H:%M:%S %z'.

`-r FILE'
`--reference=FILE'
     Display the time and date reference according to the last
     modification time of FILE, instead of the current time and date.

`-s DATESTR'
`--set=DATESTR'
     Set the time and date to DATESTR,  See `-d' above.

`-u'
`--utc'
`--universal'
     Use Coordinated Universal Time (UTC) by operating as if the `TZ'
     environment variable was set to the string `UTC0'.  Normally,
     `date' operates in the time zone indicated by `TZ', or the system
     default if `TZ' is not set.  Coordinated Universal Time is often
     called "Greenwich Mean Time" (GMT) for historical reasons.