|DATE(1)||General Commands Manual||DATE(1)|
date — display or
set date and time
date displays the current date and time
when invoked without arguments. Providing arguments will format the date and
time in a user-defined way or set the date. Only the superuser may set the
The options are as follows:
datewill set the time on all of the machines in the local group. The
datefrom setting the time for other than the current machine.
An operand with a leading plus (
signals a user-defined format string which specifies the format in which to
display the date and time. The format string may contain any of the
conversion specifications described in the
strftime(3) manual page,
as well as any arbitrary text. A <newline> character is always output
after the characters specified by the format string. The format string for
the default display is:
%a %b %e %H:%M:%S %Z %Y
If an operand does not have a leading plus sign, it is interpreted as a value for setting the system's notion of the current date and time. The canonical representation for setting the date and time is:
Everything but the minutes is optional.
Time changes for Daylight Saving and Standard Time and leap seconds and years are handled automatically.
The following environment variables affect the execution of
date '+DATE: %m/%d/%y%nTIME: %H:%M:%S'
DATE: 11/21/87 TIME: 13:36:16
sets the date to “
June 13, 1985, 4:27
sets the time to
2:32 PM, without
modifying the date.
Exit status is 0 on success, 1 if unable to set the date, and 2 if able to set the local date, but unable to set it globally.
timed(8) synchronizes the
time on many hosts, the setting of a new time value may require more than a
few seconds. On these occasions,
Network time being set’. The message
Communication error with’
timed(8) occurs when the
R. Gusella and S. Zatti, TSP: The Time Synchronization Protocol for UNIX 4.3BSD.
date utility is expected to be
compatible with IEEE Std 1003.2
|November 15, 2006||NetBSD-7.0.1|