[gentoo-dev] GLEP XX - GLEP date and time format

[gentoo-dev] GLEP XX - GLEP date and time format

[Henrik Brix Andersen]

[-- Attachment #1: Type: text/plain, Size: 1407 bytes --]

GLEP: XX
Title: GLEP date and time 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`` format
(e.g. 14-Aug-2001). This format is not internationalized and not
easily machine parsable.

This GLEP proposes switching to using an ISO-8601 compliant date
format ``yyyy-dd-mm`` (e.g. 2001-08-14). This format is international
and easily machine parseable. It also allows specifying the time of
day (e.g. ``2001-08-14T19:53:46+0000``).

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

An overview of the ISO-8601 specification is available online at
http://www.iso.org/iso/en/prods-services/popstds/datesandtime.html

The date(1) utility also 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 ISO-8601.

Copyright
=========

This document has been placed in the public domain.

-- 
Henrik Brix Andersen <brix@gentoo.org>
Gentoo Metadistribution | Mobile computing herd

[-- Attachment #2: Type: application/pgp-signature, Size: 211 bytes --]

Re: [gentoo-dev] GLEP XX - GLEP date and time format

[Henrik Brix Andersen]

[-- Attachment #1: Type: text/plain, Size: 511 bytes --]

On Tue, Dec 13, 2005 at 10:17:07PM +0100, Henrik Brix Andersen wrote:
> This GLEP proposes switching to using an ISO-8601 compliant date
> format ``yyyy-dd-mm`` (e.g. 2001-08-14). This format is international
           ^^^^^^^^^^

That should of course read ``yyyy-mm-dd``, sorry.


> and easily machine parseable. It also allows specifying the time of
> day (e.g. ``2001-08-14T19:53:46+0000``).

./Brix
-- 
Henrik Brix Andersen <brix@gentoo.org>
Gentoo Metadistribution | Mobile computing herd

[-- Attachment #2: Type: application/pgp-signature, Size: 211 bytes --]

Re: [gentoo-dev] GLEP XX - GLEP date and time format

[Henrik Brix Andersen]

[-- Attachment #1.1: Type: text/plain, Size: 550 bytes --]

On Tue, Dec 13, 2005 at 10:17:07PM +0100, Henrik Brix Andersen wrote:
> GLEP: XX
> Title: GLEP date and time format

After discussing this proposal on IRC with ciaranm and g2boojum, a few
changes have been made:

  * Restrict the GLEP to deal with dates (not time)
  * Use proper GLEP format

Since I have no idea on how to use docutils, I'd be grateful if
someone familiar with the process (Grant?) could commit this to CVS.

Regards,
Brix
-- 
Henrik Brix Andersen <brix@gentoo.org>
Gentoo Metadistribution | Mobile computing herd

[-- Attachment #1.2: glep-0045.txt --]
[-- Type: text/plain, Size: 1372 bytes --]

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.


[-- Attachment #2: Type: application/pgp-signature, Size: 211 bytes --]

Re: [gentoo-dev] GLEP XX - GLEP date and time format

[Grant Goodyear]

[-- Attachment #1: Type: text/plain, Size: 400 bytes --]

Henrik Brix Andersen wrote: [Tue Dec 13 2005, 03:41:55PM CST]
> Since I have no idea on how to use docutils, I'd be grateful if
> someone familiar with the process (Grant?) could commit this to CVS.

Committed to CVS.

-g2boojum-
-- 
Grant Goodyear	
Gentoo Developer
g2boojum@gentoo.org
http://www.gentoo.org/~g2boojum
GPG Fingerprint: D706 9802 1663 DEF5 81B0  9573 A6DC 7152 E0F6 5B76

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] GLEP XX - GLEP date and time format

[Henrik Brix Andersen]

[-- Attachment #1: Type: text/plain, Size: 212 bytes --]

On Tue, Dec 13, 2005 at 04:43:48PM -0600, Grant Goodyear wrote:
> Committed to CVS.

Thank you.

Regards,
Brix
-- 
Henrik Brix Andersen <brix@gentoo.org>
Gentoo Metadistribution | Mobile computing herd

[-- Attachment #2: Type: application/pgp-signature, Size: 211 bytes --]