Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
date(1)				 User Commands			       date(1)

       date - write the	date and time

       /usr/bin/date [-u] [ + format]

       /usr/bin/date [ -a [-] sss.fff]

       /usr/bin/date [-u] [ [mmdd] HHMM	|  mmddHHMM [cc] yy]  [.SS]

       /usr/xpg4/bin/date [-u] [ + format]

       /usr/xpg4/bin/date [ -a [-] sss.fff]

       /usr/xpg4/bin/date [-u] [ [mmdd]	HHMM |	mmddHHMM [cc] yy]  [.SS]

       The  date  utility  writes  the	date  and  time	 to standard output or
       attempts	to set the system date and time. By default, the current  date
       and time	will be	written.

       Specifications  of  native  language  translations of month and weekday
       names are supported. The	month and weekday names	used  for  a  language
       are  based on the locale	specified by the environment variable LC_TIME;
       see environ(5).

       The following is	the default form for the "C" locale:

	      %a %b %e %T %Z %Y

       for example,

       Fri Dec 23 10:10:42 EST 1988

       The following options are supported:

       - a [-]sss.fff
	     Slowly adjust the time by sss.fff seconds (fff  represents	 frac-
	     tions  of a second). This adjustment can be positive or negative.
	     The system's clock	will be	sped up	or slowed down	until  it  has
	     drifted  by  the number of	seconds	specified. Only	the super-user
	     may adjust	the time.

       -u    Display (or set) the date in Greenwich Mean Time  (GMT--universal
	     time), bypassing the normal conversion to (or from) local time.

       The following operands are supported:

	     If	 the  argument begins with +, the output of date is the	result
	     of	passing	format and the current time to strftime().  date  uses
	     the  conversion  specifications listed on the strftime(3C)	manual
	     page, with	the conversion	specification  for  %C	determined  by
	     whether /usr/bin/date or /usr/xpg4/bin/date is used:

		    Locale's date and time representation. This	is the default
		    output for date.

		    Century (a year divided by 100 and truncated to  an	 inte-
		    ger) as a decimal number [00-99].

	      The string is always terminated with a NEWLINE. An argument con-
	      taining blanks must be quoted; see the EXAMPLES section.

       mm    Month number

       dd    Day number	in the month

       HH    Hour number (24 hour system)

       MM    Minute number

       SS    Second number

       cc    Century (a	year divided by	100 and	truncated to an	integer) as  a
	     decimal  number  [00-99]. For example, cc is 19 for the year 1988
	     and 20 for	the year 2007.

       yy    Last two digits of	the year number. If century (cc) is not	speci-
	     fied, then	values in the range 69-99 shall	refer to years 1969 to
	     1999 inclusive, and values	in the	range  00-68  shall  refer  to
	     years 2000	to 2068, inclusive.

       The  month,  day,  year number, and century may be omitted; the current
       values are applied as defaults. For example, the	following entry:

       example%	date 10080045

       sets the	date to	Oct 8, 12:45 a.m. The  current	year  is  the  default
       because	no  year  is  supplied.	The system operates in GMT. date takes
       care of the conversion to and from local	standard  and  daylight	 time.
       Only the	super-user may change the date.	After successfully setting the
       date and	time, date displays the	new date according to the default for-
       mat. The	date command uses TZ to	determine the correct time zone	infor-
       mation; see environ(5).

       Example 1: Generating output

       The command

       example%	date '+DATE: %m/%d/%y%nTIME:%H:%M:%S'

       generates as output

       DATE: 08/01/76

       TIME: 14:45:05

       Example 2: Setting the current time

       The command

       example#	date 1234.56

       sets the	current	time to	12:34:56.

       Example 3: Setting another time and date	in Greenwich Mean Time

       The command

       example#	date -u	010100302000

       sets the	date to	January	1st, 12:30 am, 2000, which will	 be  displayed

       Thu Jan 01 00:30:00 GMT 2000

       See  environ(5) for descriptions	of the following environment variables
       that affect the execution of date: LC_CTYPE, LC_TIME, LC_MESSAGES,  and

	TZ   Determine	the  timezone  in which	the time and date are written,
	     unless the	-u option is specified.	 If the	TZ variable is not set
	     and the -u	is not specified, the system default timezone is used.

       The following exit values are returned:

	0    Successful	completion.

       >0    An	error occurred.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWcsu			   |
       |CSI			     |enabled			   |

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWxcu4			   |
       |CSI			     |enabled			   |

       strftime(3C), attributes(5), environ(5),	XPG4(5)

	no permission
	     You are not the super-user	and you	tried to change	the date.

       bad conversion
	     The date set is syntactically incorrect.

       If you attempt to set the current date to one of	 the  dates  that  the
       standard	 and  alternate	 time zones change (for	example, the date that
       daylight	time is	starting or ending), and you attempt to	set  the  time
       to  a  time  in	the  interval between the end of standard time and the
       beginning of the	alternate time (or the end of the alternate  time  and
       the beginning of	standard time),	the results are	unpredictable.

       Using the date command from within windowing environments to change the
       date can	lead to	unpredictable results and is unsafe. It	 may  also  be
       unsafe  in the multi-user mode, that is,	outside	of a windowing system,
       if the date is changed rapidly back and forth. The  recommended	method
       of changing the date is 'date -a'.

SunOS 5.9			  12 Dec 2000			       date(1)


Want to link to this manual page? Use this URL:

home | help