en/glep/glep-0045.txt

GLEP: 45
Title: GLEP date format
Version: $Revision: $
Author: Henrik Brix Andersen <brix@gentoo.org>
Last-Modified: $Date: $
Status: Draft
Type: Standards Track
Content-Type: text/x-rst
Created: 13-Dec-2005
Post-History: 13-Dec-2005

Abstract
========

This GLEP proposes using an ISO-8601 compliant date format in GLEPs.

Motivation
==========

The current date format used in GLEPs is ``dd-mmm-yyyy``
(e.g. 14-Aug-2001). This format is not internationalized and not
easily machine parseable.

This GLEP proposes switching to using an ISO-8601 compliant date
format ``yyyy-mm-dd`` (e.g. 2001-08-14). This format is international
and easily machine parseable.

Specification
=============

An overview of the ISO-8601 specification is available online
[#iso-8601]_. Note that only the ``yyyy-mm-dd`` subset of the ISO-8601
specification should be used in GLEPs.

The date(1) utility supports ISO-8601, making it easy for GLEP authors
to get the format right.

Backwards Compatibility
=======================

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.

References
==========

.. [#iso-8601] Numeric representation of Dates and Time,
     http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html

Copyright
=========

This document has been placed in the public domain.
1	g2boojum	1.1	GLEP: 45
2			Title: GLEP date format
3			Version: $Revision: $
4			Author: Henrik Brix Andersen <brix@gentoo.org>
5			Last-Modified: $Date: $
6			Status: Draft
7			Type: Standards Track
8			Content-Type: text/x-rst
9			Created: 13-Dec-2005
10			Post-History: 13-Dec-2005
11
12			Abstract
13			========
14
15			This GLEP proposes using an ISO-8601 compliant date format in GLEPs.
16
17			Motivation
18			==========
19
20			The current date format used in GLEPs is ``dd-mmm-yyyy``
21			(e.g. 14-Aug-2001). This format is not internationalized and not
22			easily machine parseable.
23
24			This GLEP proposes switching to using an ISO-8601 compliant date
25			format ``yyyy-mm-dd`` (e.g. 2001-08-14). This format is international
26			and easily machine parseable.
27
28			Specification
29			=============
30
31			An overview of the ISO-8601 specification is available online
32			[#iso-8601]_. Note that only the ``yyyy-mm-dd`` subset of the ISO-8601
33			specification should be used in GLEPs.
34
35			The date(1) utility supports ISO-8601, making it easy for GLEP authors
36			to get the format right.
37
38			Backwards Compatibility
39			=======================
40
41			GLEP 1 should be updated to reflect this new date format, and all
42			dates in existing GLEPs should be changed to be ISO-8601 compliant.
43
44			References
45			==========
46
47			.. [#iso-8601] Numeric representation of Dates and Time,
48			http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html
49
50			Copyright
51			=========
52
53			This document has been placed in the public domain.