Penguin

Differences between current version and predecessor to the previous major change of date(1).

Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History

Newer page: version 4 Last edited on Monday, October 15, 2007 3:55:06 pm by IanMcDonald
Older page: version 3 Last edited on Wednesday, September 10, 2003 8:32:13 pm by GreigMcGill Revert
@@ -1,342 +1,167 @@
-DATE  
-!!!DATE  
+<verbatim>  
 NAME 
+ date - print or set the system date and time  
+  
 SYNOPSIS 
+ date [OPTION]... [+FORMAT]  
+ date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]  
+  
 DESCRIPTION 
-AUTHOR  
-REPORTING BUGS  
-COPYRIGHT  
-SEE ALSO  
-----  
-!!NAME  
+ Display the current time in the given FORMAT, or set the system date.  
  
+ -d, --date=STRING  
+ display time described by STRING, not ‘now’  
  
-date - print or set the system date and time  
-!!SYNOPSIS  
+ -f, --file=DATEFILE  
+ like --date once for each line of DATEFILE  
  
+ -r, --reference=FILE  
+ display the last modification time of FILE  
  
-__date__ [[''OPTION'']... [[''+FORMAT'']__  
-date__ [['' -u| --utc| --universal'']  
-[[''MMDDhhmm''[[[[''CC'']''YY''][[''.ss'']]  
-!!DESCRIPTION  
+ -R, --rfc -2822  
+ output date and time in RFC 2822 format  
  
+ --rfc-3339=TIMESPEC  
+ output date and time in RFC 3339 format. TIMESPEC=‘date’, ‘sec‐  
+ onds’, or ‘ns’ for date and time to the indicated precision.  
  
-Display the current time in the given FORMAT , or set the  
-system date.  
+ -s , -- set=STRING  
+ set time described by STRING  
  
+ -u, --utc, --universal  
+ print or set Coordinated Universal Time  
  
-__ -d__, __ --date__=''STRING''  
+ --help display this help and exit  
  
+ --version  
+ output version information and exit  
  
-display time described by STRING, not `now'  
+ FORMAT controls the output. The only valid option for the second form  
+ specifies Coordinated Universal Time. Interpreted sequences are:  
  
+ %% a literal %  
  
-__-f__ , __--file__=''DATEFILE''  
+ %a locale’s abbreviated weekday name (e.g. , Sun)  
  
+ %A locale’s full weekday name (e.g., Sunday)  
  
-like __--date__ once for each line of  
-DATEFILE  
+ %b locale’s abbreviated month name (e.g., Jan)  
  
+ %B locale’s full month name (e.g., January)  
  
-__-I__, __--iso-8601__[[=''TIMESPEC''] output an  
-ISO-8601 compliant date/ time string
+ %c locale’s date and time (e .g., Thu Mar 3 23:05:25 2005)  
  
+ %C century; like %Y, except omit last two digits (e.g., 21)  
  
-TIMESPEC=`date' (or missing ) for date only, `hours',  
-`minutes', or `seconds' for date and time to the indicated  
-precision.  
+ %d day of month (e.g, 01
  
+ %D date; same as %m/%d/%y  
  
-__-r__ , __--reference__=''FILE''  
+ %e day of month , space padded; same as % _d  
  
+ %F full date; same as %Y-%m-%d  
  
-display the last modification time of FILE  
+ %g last two digits of year of ISO week number (see %G)  
  
+ %G year of ISO week number (see %V); normally useful only with %V  
  
-__-R__, __--rfc-822__  
+ %h same as %b  
  
+ %H hour (00..23)  
  
-output RFC-822 compliant date string  
+ %I hour (01..12)  
  
+ %j day of year (001..366)  
  
-__-s__, __--set__=''STRING''  
+ %k hour ( ..23)  
  
+ %l hour ( 1..12)  
  
-set time described by STRING  
+ %m month (01..12)  
  
+ %M minute (00..59)  
  
-__-u__, __--utc__, __--universal__  
+ %n a newline  
  
+ %N nanoseconds (000000000..999999999)  
  
-print or set Coordinated Universal Time  
+ %p locale’s equivalent of either AM or PM; blank if not known  
  
+ %P like %p, but lower case  
  
-__ --help__  
+ %r locale’s 12 -hour clock time (e.g., 11:11:04 PM)  
  
+ %R 24-hour hour and minute; same as %H:%M  
  
-display this help and exit  
+ %s seconds since 1970-01-01 00:00:00 UTC  
  
+ %S second (00..60)  
  
-__--version__  
+ %t a tab  
  
+ %T time; same as %H:%M:%S  
  
-output version information and exit  
+ %u day of week (1..7); 1 is Monday  
  
+ %U week number of year, with Sunday as first day of week (00..53)  
  
-FORMAT controls the output . The only valid option for the  
-second form specifies Coordinated Universal Time .  
-Interpreted sequences are:  
+ %V ISO week number, with Monday as first day of week (01 ..53)  
  
+ %w day of week (0..6); 0 is Sunday  
  
-%%  
+ %W week number of year, with Monday as first day of week (00..53)  
  
+ %x locale’s date representation (e.g., 12/31/99)  
  
-a literal
+ %X locale’s time representation (e.g., 23:13:48)  
  
+ %y last two digits of year (00..99)  
  
-%a  
+ %Y year  
  
+ %z +hhmm numeric timezone (e.g., -0400)  
  
-locale's abbreviated weekday name (Sun ..Sat
+ %:z +hh:mm numeric timezone (e .g ., -04:00
  
+ %::z +hh:mm:ss numeric time zone (e.g., -04:00:00)  
  
-%A  
+ %:::z numeric time zone with : to necessary precision (e.g., -04,  
+ +05:30)  
  
+ %Z alphabetic time zone abbreviation (e.g., EDT)  
  
-locale's full weekday name , variable length  
-(Sunday..Saturday)  
+ By default , date pads numeric fields with zeroes. The following  
+ optional flags may follow ‘%’:  
  
+ - (hyphen) do not pad the field _ (underscore) pad with spaces 0  
+ (zero) pad with zeros ^ use upper case if possible # use oppo‐  
+ site case if possible  
  
-%b  
+ After any flags comes an optional field width, as a decimal number;  
+ then an optional modifier, which is either E to use the locale’s alter‐  
+ nate representations if available, or O to use the locale’s alternate  
+ numeric symbols if available.  
  
+AUTHOR  
+ Written by David MacKenzie.  
  
-locale's abbreviated month name (Jan ..Dec)  
+REPORTING BUGS  
+ Report bugs to <bug-coreutils@gnu .org>
  
+COPYRIGHT  
+ Copyright © 2006 Free Software Foundation, Inc.  
+ This is free software. You may redistribute copies of it under the  
+ terms of the GNU General Public License  
+ <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the  
+ extent permitted by law.  
  
-%B  
-  
-  
-locale's full month name, variable length  
-(January..December)  
-  
-  
-%c  
-  
-  
-locale's date and time (Sat Nov 04 12:02:33 EST  
-1989)  
-  
-  
-%d  
-  
-  
-day of month (01..31)  
-  
-  
-%D  
-  
-  
-date (mm/dd/yy)  
-  
-  
-%e  
-  
-  
-day of month, blank padded ( 1..31)  
-  
-  
-%h  
-  
-  
-same as %b  
-  
-  
-%H  
-  
-  
-hour (00..23)  
-  
-  
-%I  
-  
-  
-hour (01..12)  
-  
-  
-%j  
-  
-  
-day of year (001..366)  
-  
-  
-%k  
-  
-  
-hour ( ..23)  
-  
-  
-%l  
-  
-  
-hour ( 1..12)  
-  
-  
-%m  
-  
-  
-month (01..12)  
-  
-  
-%M  
-  
-  
-minute (00..59)  
-  
-  
-%n  
-  
-  
-a newline  
-  
-  
-%p  
-  
-  
-locale's AM or PM  
-  
-  
-%r  
-  
-  
-time, 12-hour (hh:mm:ss [[AP]M)  
-  
-  
-%s  
-  
-  
-seconds since `00:00:00 1970-01-01 UTC' (a GNU  
-extension)  
-  
-  
-%S  
-  
-  
-second (00..60)  
-  
-  
-%t  
-  
-  
-a horizontal tab  
-  
-  
-%T  
-  
-  
-time, 24-hour (hh:mm:ss)  
-  
-  
-%U  
-  
-  
-week number of year with Sunday as first day of week  
-(00..53)  
-  
-  
-%V  
-  
-  
-week number of year with Monday as first day of week  
-(01..53)  
-  
-  
-%w  
-  
-  
-day of week (..6); 0 represents Sunday  
-  
-  
-%W  
-  
-  
-week number of year with Monday as first day of week  
-(00..53)  
-  
-  
-%x  
-  
-  
-locale's date representation (mm/dd/yy)  
-  
-  
-%X  
-  
-  
-locale's time representation (%H:%M:%S)  
-  
-  
-%y  
-  
-  
-last two digits of year (00..99)  
-  
-  
-%Y  
-  
-  
-year (1970...)  
-  
-  
-%z  
-  
-  
-RFC-822 style numeric timezone (-0500) (a nonstandard  
-extension)  
-  
-  
-%Z  
-  
-  
-time zone (e.g., EDT), or nothing if no time zone is  
-determinable  
-  
-  
-By default, date pads numeric fields with zeroes. GNU date  
-recognizes the following modifiers between `%' and a numeric  
-directive.  
-  
-  
-`-' (hyphen) do not pad the field `_' (underscore) pad the  
-field with spaces  
-!!AUTHOR  
-  
-  
-Written by David !MacKenzie.  
-!!REPORTING BUGS  
-  
-  
-Report bugs to  
-!!COPYRIGHT  
-  
-  
-Copyright 2000 Free Software Foundation, Inc.  
-This is free software; see the source for copying  
-conditions. There is NO warranty; not even for  
-MERCHANTABILITY or FITNESS FOR A PARTICULAR  
-PURPOSE.  
-!! SEE ALSO  
-  
-  
- The full documentation for __ date__ is maintained as a  
- Texinfo manual. If the __ info__ and __ date__ programs  
- are properly installed at your site, the  
-command  
-  
-  
-__info date__  
+SEE ALSO  
+ The full documentation for date is maintained as a Texinfo manual. If  
+ the info and date programs are properly installed at your site, the  
+ command 
  
+ info date  
  
-should give you access to the complete manual.  
-----  
+ should give you access to the complete manual. 
  
-See also: 822-date(1)  
+</verbatim>  
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.