en/glep/glep-0045.html

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
  <title>GLEP 45 -- GLEP date format</title>
  <link rel="stylesheet" href="tools/glep.css" type="text/css" />
</head>
<body bgcolor="white">
<table class="navigation" cellpadding="0" cellspacing="0"
       width="100%" border="0">
<tr><td class="navicon" width="150" height="35">
<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
 border="0" width="150" height="35" /></a></td>
<td class="textlinks" align="left">
[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0045.txt">GLEP Source</a></b>]
</td></tr></table>
<table class="rfc2822 docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">45</td>
</tr>
<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP date format</td>
</tr>
<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td>
</tr>
<tr class="field"><th class="field-name">Author:</th><td class="field-body">Henrik Brix Andersen &lt;brix&#32;&#97;t&#32;gentoo.org&gt;</td>
</tr>
<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0045.txt?cvsroot=gentoo">2005/12/13 22:42:27</a></td>
</tr>
<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
</tr>
<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
</tr>
<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
</tr>
<tr class="field"><th class="field-name">Created:</th><td class="field-body">13-Dec-2005</td>
</tr>
<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">13-Dec-2005</td>
</tr>
</tbody>
</table>
<hr />
<div class="contents topic">
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
<ul class="simple">
<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li>
<li><a class="reference" href="#motivation" id="id3" name="id3">Motivation</a></li>
<li><a class="reference" href="#specification" id="id4" name="id4">Specification</a></li>
<li><a class="reference" href="#backwards-compatibility" id="id5" name="id5">Backwards Compatibility</a></li>
<li><a class="reference" href="#references" id="id6" name="id6">References</a></li>
<li><a class="reference" href="#copyright" id="id7" name="id7">Copyright</a></li>
</ul>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id2" id="abstract" name="abstract">Abstract</a></h1>
<p>This GLEP proposes using an ISO-8601 compliant date format in GLEPs.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id3" id="motivation" name="motivation">Motivation</a></h1>
<p>The current date format used in GLEPs is <tt class="docutils literal"><span class="pre">dd-mmm-yyyy</span></tt>
(e.g. 14-Aug-2001). This format is not internationalized and not
easily machine parseable.</p>
<p>This GLEP proposes switching to using an ISO-8601 compliant date
format <tt class="docutils literal"><span class="pre">yyyy-mm-dd</span></tt> (e.g. 2001-08-14). This format is international
and easily machine parseable.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id4" id="specification" name="specification">Specification</a></h1>
<p>An overview of the ISO-8601 specification is available online
<a class="footnote-reference" href="#iso-8601" id="id1" name="id1">[1]</a>. Note that only the <tt class="docutils literal"><span class="pre">yyyy-mm-dd</span></tt> subset of the ISO-8601
specification should be used in GLEPs.</p>
<p>The date(1) utility supports ISO-8601, making it easy for GLEP authors
to get the format right.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id5" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
<p>GLEP 1 should be updated to reflect this new date format, and all
dates in existing GLEPs should be changed to be ISO-8601 compliant.</p>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id6" id="references" name="references">References</a></h1>
<table class="docutils footnote" frame="void" id="iso-8601" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1" name="iso-8601">[1]</a></td><td>Numeric representation of Dates and Time,
<a class="reference" href="http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html">http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html</a></td></tr>
</tbody>
</table>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id7" id="copyright" name="copyright">Copyright</a></h1>
<p>This document has been placed in the public domain.</p>
</div>

</div>
<div class="footer">
<hr class="footer" />
<a class="reference" href="glep-0045.txt">View document source</a>.
Generated on: 2007-10-13 13:39 UTC.
Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.

</div>
</body>
</html>
1	<?xml version="1.0" encoding="utf-8" ?>
2	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
5	<head>
6	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7	<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
8	<title>GLEP 45 -- GLEP date format</title>
9	<link rel="stylesheet" href="tools/glep.css" type="text/css" />
10	</head>
11	<body bgcolor="white">
12	<table class="navigation" cellpadding="0" cellspacing="0"
13	width="100%" border="0">
14	<tr><td class="navicon" width="150" height="35">
15	<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
16	<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
17	border="0" width="150" height="35" /></a></td>
18	<td class="textlinks" align="left">
19	[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
20	[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
21	[<b><a href="http://www.gentoo.org/proj/en/glep/glep-0045.txt">GLEP Source</a></b>]
22	</td></tr></table>
23	<table class="rfc2822 docutils field-list" frame="void" rules="none">
24	<col class="field-name" />
25	<col class="field-body" />
26	<tbody valign="top">
27	<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">45</td>
28	</tr>
29	<tr class="field"><th class="field-name">Title:</th><td class="field-body">GLEP date format</td>
30	</tr>
31	<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td>
32	</tr>
33	<tr class="field"><th class="field-name">Author:</th><td class="field-body">Henrik Brix Andersen <brix at gentoo.org></td>
34	</tr>
35	<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0045.txt?cvsroot=gentoo">2005/12/13 22:42:27</a></td>
36	</tr>
37	<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
38	</tr>
39	<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
40	</tr>
41	<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
42	</tr>
43	<tr class="field"><th class="field-name">Created:</th><td class="field-body">13-Dec-2005</td>
44	</tr>
45	<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">13-Dec-2005</td>
46	</tr>
47	</tbody>
48	</table>
49	<hr />
50	<div class="contents topic">
51	<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
52	<ul class="simple">
53	<li><a class="reference" href="#abstract" id="id2" name="id2">Abstract</a></li>
54	<li><a class="reference" href="#motivation" id="id3" name="id3">Motivation</a></li>
55	<li><a class="reference" href="#specification" id="id4" name="id4">Specification</a></li>
56	<li><a class="reference" href="#backwards-compatibility" id="id5" name="id5">Backwards Compatibility</a></li>
57	<li><a class="reference" href="#references" id="id6" name="id6">References</a></li>
58	<li><a class="reference" href="#copyright" id="id7" name="id7">Copyright</a></li>
59	</ul>
60	</div>
61	<div class="section">
62	<h1><a class="toc-backref" href="#id2" id="abstract" name="abstract">Abstract</a></h1>
63	<p>This GLEP proposes using an ISO-8601 compliant date format in GLEPs.</p>
64	</div>
65	<div class="section">
66	<h1><a class="toc-backref" href="#id3" id="motivation" name="motivation">Motivation</a></h1>
67	<p>The current date format used in GLEPs is <tt class="docutils literal"><span class="pre">dd-mmm-yyyy</span></tt>
68	(e.g. 14-Aug-2001). This format is not internationalized and not
69	easily machine parseable.</p>
70	<p>This GLEP proposes switching to using an ISO-8601 compliant date
71	format <tt class="docutils literal"><span class="pre">yyyy-mm-dd</span></tt> (e.g. 2001-08-14). This format is international
72	and easily machine parseable.</p>
73	</div>
74	<div class="section">
75	<h1><a class="toc-backref" href="#id4" id="specification" name="specification">Specification</a></h1>
76	<p>An overview of the ISO-8601 specification is available online
77	<a class="footnote-reference" href="#iso-8601" id="id1" name="id1">[1]</a>. Note that only the <tt class="docutils literal"><span class="pre">yyyy-mm-dd</span></tt> subset of the ISO-8601
78	specification should be used in GLEPs.</p>
79	<p>The date(1) utility supports ISO-8601, making it easy for GLEP authors
80	to get the format right.</p>
81	</div>
82	<div class="section">
83	<h1><a class="toc-backref" href="#id5" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
84	<p>GLEP 1 should be updated to reflect this new date format, and all
85	dates in existing GLEPs should be changed to be ISO-8601 compliant.</p>
86	</div>
87	<div class="section">
88	<h1><a class="toc-backref" href="#id6" id="references" name="references">References</a></h1>
89	<table class="docutils footnote" frame="void" id="iso-8601" rules="none">
90	<colgroup><col class="label" /><col /></colgroup>
91	<tbody valign="top">
92	<tr><td class="label"><a class="fn-backref" href="#id1" name="iso-8601">[1]</a></td><td>Numeric representation of Dates and Time,
93	<a class="reference" href="http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html">http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html</a></td></tr>
94	</tbody>
95	</table>
96	</div>
97	<div class="section">
98	<h1><a class="toc-backref" href="#id7" id="copyright" name="copyright">Copyright</a></h1>
99	<p>This document has been placed in the public domain.</p>
100	</div>
101
102	</div>
103	<div class="footer">
104	<hr class="footer" />
105	<a class="reference" href="glep-0045.txt">View document source</a>.
106	Generated on: 2007-10-13 13:39 UTC.
107	Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
108
109	</div>
110	</body>
111	</html>