/usr/share/doc/mailutils-doc/mailutils.html/General-date-syntax.html is in mailutils-doc 1:2.99.99-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA
Copyright (C) 1999-2004, 2008-2012, 2014-2015 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover, and no Back-Cover texts.
A copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: General date syntax</title>
<meta name="description" content="GNU Mailutils Manual: General date syntax">
<meta name="keywords" content="GNU Mailutils Manual: General date syntax">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Date-Input-Formats.html#Date-Input-Formats" rel="up" title="Date Input Formats">
<link href="Calendar-date-items.html#Calendar-date-items" rel="next" title="Calendar date items">
<link href="Date-Input-Formats.html#Date-Input-Formats" rel="prev" title="Date Input Formats">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="General-date-syntax"></a>
<div class="header">
<p>
Next: <a href="Calendar-date-items.html#Calendar-date-items" accesskey="n" rel="next">Calendar date items</a>, Up: <a href="Date-Input-Formats.html#Date-Input-Formats" accesskey="u" rel="up">Date Input Formats</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="General-date-syntax-1"></a>
<h3 class="section">B.1 General date syntax</h3>
<a name="index-general-date-syntax"></a>
<a name="index-items-in-date-strings"></a>
<p>A <em>date</em> is a string, possibly empty, containing many items
separated by whitespace. The whitespace may be omitted when no
ambiguity arises. The empty string means the beginning of today (i.e.,
midnight). Order of the items is immaterial. A date string may contain
many flavors of items:
</p>
<ul>
<li> calendar date items
</li><li> time of day items
</li><li> time zone items
</li><li> day of the week items
</li><li> relative items
</li><li> pure numbers.
</li></ul>
<p>We describe each of these item types in turn, below.
</p>
<a name="index-numbers_002c-written_002dout"></a>
<a name="index-ordinal-numbers"></a>
<a name="index-first-in-date-strings"></a>
<a name="index-next-in-date-strings"></a>
<a name="index-last-in-date-strings"></a>
<p>A few ordinal numbers may be written out in words in some contexts. This is
most useful for specifying day of the week items or relative items (see
below). Among the most commonly used ordinal numbers, the word
‘<samp>last</samp>’ stands for <em>-1</em>, ‘<samp>this</samp>’ stands for 0, and
‘<samp>first</samp>’ and ‘<samp>next</samp>’ both stand for 1. Because the word
‘<samp>second</samp>’ stands for the unit of time there is no way to write the
ordinal number 2, but for convenience ‘<samp>third</samp>’ stands for 3,
‘<samp>fourth</samp>’ for 4, ‘<samp>fifth</samp>’ for 5,
‘<samp>sixth</samp>’ for 6, ‘<samp>seventh</samp>’ for 7, ‘<samp>eighth</samp>’ for 8,
‘<samp>ninth</samp>’ for 9, ‘<samp>tenth</samp>’ for 10, ‘<samp>eleventh</samp>’ for 11 and
‘<samp>twelfth</samp>’ for 12.
</p>
<a name="index-months_002c-written_002dout"></a>
<p>When a month is written this way, it is still considered to be written
numerically, instead of being “spelled in full”; this changes the
allowed strings.
</p>
<a name="index-language_002c-in-dates"></a>
<p>In the current implementation, only English is supported for words and
abbreviations like ‘<samp>AM</samp>’, ‘<samp>DST</samp>’, ‘<samp>EST</samp>’, ‘<samp>first</samp>’,
‘<samp>January</samp>’, ‘<samp>Sunday</samp>’, ‘<samp>tomorrow</samp>’, and ‘<samp>year</samp>’.
</p>
<a name="index-language_002c-in-dates-1"></a>
<a name="index-time-zone-item"></a>
<p>The output of the <code>date</code> command
is not always acceptable as a date string,
not only because of the language problem, but also because there is no
standard meaning for time zone items like ‘<samp>IST</samp>’. When using
<code>date</code> to generate a date string intended to be parsed later,
specify a date format that is independent of language and that does not
use time zone items other than ‘<samp>UTC</samp>’ and ‘<samp>Z</samp>’. Here are some
ways to do this:
</p>
<div class="example">
<pre class="example">$ LC_ALL=C TZ=UTC0 date
Mon Mar 1 00:21:42 UTC 2004
$ TZ=UTC0 date +'%Y-%m-%d %H:%M:%SZ'
2004-03-01 00:21:42Z
$ date --iso-8601=ns | tr T ' ' # --iso-8601 is a GNU extension.
2004-02-29 16:21:42,692722128-0800
$ date --rfc-2822 # a GNU extension
Sun, 29 Feb 2004 16:21:42 -0800
$ date +'%Y-%m-%d %H:%M:%S %z' # %z is a GNU extension.
2004-02-29 16:21:42 -0800
$ date +'@%s.%N' # %s and %N are GNU extensions.
@1078100502.692722128
</pre></div>
<a name="index-case_002c-ignored-in-dates"></a>
<a name="index-comments_002c-in-dates"></a>
<p>Alphabetic case is completely ignored in dates. Comments may be introduced
between round parentheses, as long as included parentheses are properly
nested. Hyphens not followed by a digit are currently ignored. Leading
zeros on numbers are ignored.
</p>
<p>Invalid dates like ‘<samp>2005-02-29</samp>’ or times like ‘<samp>24:00</samp>’ are
rejected. In the typical case of a host that does not support leap
seconds, a time like ‘<samp>23:59:60</samp>’ is rejected even if it
corresponds to a valid leap second.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Calendar-date-items.html#Calendar-date-items" accesskey="n" rel="next">Calendar date items</a>, Up: <a href="Date-Input-Formats.html#Date-Input-Formats" accesskey="u" rel="up">Date Input Formats</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|