diff options
Diffstat (limited to 'man/date.1')
| -rw-r--r-- | man/date.1 | 229 |
1 files changed, 229 insertions, 0 deletions
diff --git a/man/date.1 b/man/date.1 new file mode 100644 index 0000000..b88152d --- /dev/null +++ b/man/date.1 @@ -0,0 +1,229 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH DATE "1" "March 2007" "GNU coreutils 6.9" "User Commands" +.SH NAME +date \- print or set the system date and time +.SH SYNOPSIS +.B date +[\fIOPTION\fR]... [\fI+FORMAT\fR] +.br +.B date +[\fI-u|--utc|--universal\fR] [\fIMMDDhhmm\fR[[\fICC\fR]\fIYY\fR][\fI.ss\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Display the current time in the given FORMAT, or set the system date. +.TP +\fB\-d\fR, \fB\-\-date\fR=\fISTRING\fR +display time described by STRING, not `now' +.TP +\fB\-f\fR, \fB\-\-file\fR=\fIDATEFILE\fR +like \fB\-\-date\fR once for each line of DATEFILE +.TP +\fB\-r\fR, \fB\-\-reference\fR=\fIFILE\fR +display the last modification time of FILE +.TP +\fB\-R\fR, \fB\-\-rfc\-2822\fR +output date and time in RFC 2822 format. +Example: Mon, 07 Aug 2006 12:34:56 \fB\-0600\fR +.TP +\fB\-\-rfc\-3339\fR=\fITIMESPEC\fR +output date and time in RFC 3339 format. +TIMESPEC=`date', `seconds', or `ns' for +date and time to the indicated precision. +Date and time components are separated by +a single space: 2006\-08\-07 12:34:56\-06:00 +.TP +\fB\-s\fR, \fB\-\-set\fR=\fISTRING\fR +set time described by STRING +.TP +\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR +print or set Coordinated Universal Time +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +FORMAT controls the output. The only valid option for the second form +specifies Coordinated Universal Time. Interpreted sequences are: +.TP +%% +a literal % +.TP +%a +locale's abbreviated weekday name (e.g., Sun) +.TP +%A +locale's full weekday name (e.g., Sunday) +.TP +%b +locale's abbreviated month name (e.g., Jan) +.TP +%B +locale's full month name (e.g., January) +.TP +%c +locale's date and time (e.g., Thu Mar 3 23:05:25 2005) +.TP +%C +century; like %Y, except omit last two digits (e.g., 21) +.TP +%d +day of month (e.g, 01) +.TP +%D +date; same as %m/%d/%y +.TP +%e +day of month, space padded; same as %_d +.TP +%F +full date; same as %Y\-%m\-%d +.TP +%g +last two digits of year of ISO week number (see %G) +.TP +%G +year of ISO week number (see %V); normally useful only with %V +.TP +%h +same as %b +.TP +%H +hour (00..23) +.TP +%I +hour (01..12) +.TP +%j +day of year (001..366) +.TP +%k +hour ( 0..23) +.TP +%l +hour ( 1..12) +.TP +%m +month (01..12) +.TP +%M +minute (00..59) +.TP +%n +a newline +.TP +%N +nanoseconds (000000000..999999999) +.TP +%p +locale's equivalent of either AM or PM; blank if not known +.TP +%P +like %p, but lower case +.TP +%r +locale's 12\-hour clock time (e.g., 11:11:04 PM) +.TP +%R +24\-hour hour and minute; same as %H:%M +.TP +%s +seconds since 1970\-01\-01 00:00:00 UTC +.TP +%S +second (00..60) +.TP +%t +a tab +.TP +%T +time; same as %H:%M:%S +.TP +%u +day of week (1..7); 1 is Monday +.TP +%U +week number of year, with Sunday as first day of week (00..53) +.TP +%V +ISO week number, with Monday as first day of week (01..53) +.TP +%w +day of week (0..6); 0 is Sunday +.TP +%W +week number of year, with Monday as first day of week (00..53) +.TP +%x +locale's date representation (e.g., 12/31/99) +.TP +%X +locale's time representation (e.g., 23:13:48) +.TP +%y +last two digits of year (00..99) +.TP +%Y +year +.TP +%z ++hhmm numeric timezone (e.g., \fB\-0400\fR) +.TP +%:z ++hh:mm numeric timezone (e.g., \fB\-04\fR:00) +.TP +%::z ++hh:mm:ss numeric time zone (e.g., \fB\-04\fR:00:00) +.TP +%:::z +numeric time zone with : to necessary precision (e.g., \fB\-04\fR, +05:30) +.TP +%Z +alphabetic time zone abbreviation (e.g., EDT) +.PP +By default, date pads numeric fields with zeroes. +The following optional flags may follow `%': +.TP +\- +(hyphen) do not pad the field +.TP +_ +(underscore) pad with spaces +.TP +0 +(zero) pad with zeros +.TP +^ +use upper case if possible +.TP +# +use opposite case if possible +.PP +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 alternate representations if available, or +O to use the locale's alternate numeric symbols if available. +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +Report bugs to <bug\-coreutils@gnu.org>. +.SH COPYRIGHT +Copyright \(co 2007 Free Software Foundation, Inc. +.br +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. +.SH "SEE ALSO" +The full documentation for +.B date +is maintained as a Texinfo manual. If the +.B info +and +.B date +programs are properly installed at your site, the command +.IP +.B info date +.PP +should give you access to the complete manual. |