date

date [OPTION]... [+FORMAT]...
date [OPTION]... [MMDDhhmm[[CC]YY][.ss]]

Print or set the system date and time

Options

--date=<STRING>, -d <STRING>

display time described by STRING, not 'now'

--file=<DATEFILE>, -f <DATEFILE>

like --date; once for each line of DATEFILE

--iso-8601=<FMT>, -I <FMT>

output date/time in ISO 8601 format.
FMT='date' for date only (the default),
'hours', 'minutes', 'seconds', or 'ns'
for date and time to the indicated precision.
Example: 2006-08-14T02:34:56-06:00

--rfc-email, -R

output date and time in RFC 5322 format.
Example: Mon, 14 Aug 2006 02:34:56 -0600

--rfc-3339=<FMT>

output date/time in RFC 3339 format.
FMT='date', 'seconds', or 'ns'
for date and time to the indicated precision.
Example: 2006-08-14 02:34:56-06:00

--debug

annotate the parsed date, and warn about questionable usage to stderr

--reference=<FILE>, -r <FILE>

display the last modification time of FILE

--set=<STRING>, -s <STRING>

set time described by STRING

--universal, -u

print or set Coordinated Universal Time (UTC)

Examples

Display the current date using the default locale's format:

date +%c

Display the current date in UTC, using the ISO 8601 format:

date -u +%Y-%m-%dT%H:%M:%S%Z

Display the current date as a Unix timestamp (seconds since the Unix epoch):

date +%s

Convert a date specified as a Unix timestamp to the default format:

date -d @{{1473305798}}

Convert a given date to the Unix timestamp format:

date -d "{{2018-09-01 00:00}}" +%s --utc

Display the current date using the RFC-3339 format (YYYY-MM-DD hh:mm:ss TZ):

date --rfc-3339 s

Set the current date using the format MMDDhhmmYYYY.ss (YYYY and .ss are optional):

date {{093023592021.59}}

Display the current ISO week number:

date +%V

The examples are provided by the tldr-pages project under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.