[0m


DATE(1V)	    UNIX Programmer's Manual		 DATE(1V)



[1mNAME
     [0mdate - print the date.

[1mSYNOPSIS
     /usr/5bin/date mmddhhmm[yy]
     /usr/5bin/date [+format]

DESCRIPTION
     [0m_D_a_t_e prints out the current time and date if no argument is
     given.

     If an argument is given of the form mmddhhmm[yy], _d_a_t_e
     attempts to set the system time to the value given in the
     argument.	The setting of the system date is only possible
     if the user has appropriate privileges and the system allows
     the setting of the system date.

     The argument is broken down as follows.  The first _m_m is the
     month (01-12); _d_d is the day (01-31); _h_h is the hour (00-
     23); the second _m_m is the minute (00-59) and _y_y is the last
     two digits of the year and is optional.

     For example:

	  date 10080045

     sets the date to October 8, 00:45. If _y_y is omitted then the
     current year is the default.

     The system operates in GMT; _d_a_t_e takes care of the conver-
     sion to and from local time.  It is possible to override the
     default timezone using the environment variable _T_Z, see
     _c_t_i_m_e().

     If the argument given begins with a +, date's output is
     under the control of the user.  The output format is similar
     to the first argument in the _p_r_i_n_t_f() function.  All output
     fields are of fixed size (padded with zeros if necessary).
     Each field descriptor is preceded by a % character and will
     be replaced in the output by its corresponding value.  A
     single % can be introduced into the output character stream
     with %%.  All other characters are copied to the output
     without change The string will always be terminated with a
     newline character.

     Field descriptors:

     [1ma	  [0mabbreviated weekday name.

     [1mA	  [0mfull weekday name.

     [1mb	  [0mabbreviated month name.



Printed 20/5/94     Revision 1.2 of 22/11/90			1






DATE(1V)	    UNIX Programmer's Manual		 DATE(1V)



     [1mB	  [0mfull month name.

     [1mc	  [0mcurrent date and time representation.

     [1md	  [0mday of month - [01,31].

     [1mD	  [0mdate as %m/%d/%y

     [1mh	  [0mabbreviated month name.

     [1mH	  [0mhour - [00,23]

     [1mI	  [0mhour - [00-12]

     [1mj	  [0mday of year - [001,366]

     [1mm	  [0mmonth of year - [01,12]

     [1mM	  [0mminute - [00,59]

     [1mn	  [0minsert a newline character.

     [1mp	  [0mam or pm.

     [1mr	  [0mtime in am//pm notation.

     [1mS	  [0msecond - [00,61]

     [1mt	  [0minsert a tab character.

     [1mT	  [0mtime as %H:%M:%S

     [1mU	  [0mweek number of the year (Sunday being classed as the
	  first day of the week) as a decimal number [00,53]

     [1mw	  [0mday of week [0,6] (Sunday = day 0)

     [1mW	  [0mweek number of the year (Monday being classed as the
	  first day of the week) as a decimal number [00,53]

     [1mx	  [0mcurrent date representation.

     [1mX	  [0mcurrent time representation.

     [1my	  [0mlast two digits of year - [00,99]

     [1mY	  [0myear with century as a decimal number.

     [1mZ	  [0mtimezone name, or no characters if timezone doesn't
	  exist.

     This utility operates in an 8-bit transparent manner.



Printed 20/5/94     Revision 1.2 of 22/11/90			2






DATE(1V)	    UNIX Programmer's Manual		 DATE(1V)



[1mEXAMPLE
     [0mThis argument

	  date '+THE DATE TODAY IS: %a %d %B %Y%nTHE TIME IS: %T'

     generates the following output

	  THE DATE TODAY IS: Mon 8 October 1990
	  THE TIME IS: 19:27:52


[1mSEE ALSO
     [0mdate(1).

[1mBUGS
     [0mIf the output stream is greater than 200 characters long
     then there will be no output displayed.






































Printed 20/5/94     Revision 1.2 of 22/11/90			3



[0m