[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] doc: improve ISO 8601 discussion
From: |
Paul Eggert |
Subject: |
[PATCH] doc: improve ISO 8601 discussion |
Date: |
Sun, 06 Jan 2013 07:33:05 -0800 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/17.0 Thunderbird/17.0 |
I pushed this:
---
ChangeLog | 7 +++++++
doc/parse-datetime.texi | 33 ++++++++++++++++++---------------
2 files changed, 25 insertions(+), 15 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 4af58eb..0e31877 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2013-01-06 Paul Eggert <address@hidden>
+
+ doc: improve ISO 8601 discussion
+ * doc/parse-datetime.texi (Combined date and time of day items):
+ Specify more carefully what formats are supported and what is
+ done with excess precision.
+
2013-01-05 Paul Eggert <address@hidden>
doc: avoid small caps
diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi
index cae4a3d..6b3e973 100644
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -51,7 +51,7 @@ arguments to the various programs. The C interface (via the
* Calendar date items:: 19 Dec 1994.
* Time of day items:: 9:20pm.
* Time zone items:: EST, PDT, UTC, @dots{}
-* Combined date and time of day items:: 1972-09-24T20:02:00,000000-0500
+* Combined date and time of day items:: 1972-09-24T20:02:00,000000-0500.
* Day of week items:: Monday and others.
* Relative items in date strings:: next tuesday, 2 years ago.
* Pure numbers in date strings:: 19931219, 1440.
@@ -319,24 +319,27 @@ time stamps are interpreted using the rules of the
default time zone
@section Combined date and time of day items
@cindex combined date and time of day item
-
-A @dfn{combined date and time of day item} specifies the time on a
-specific day of the year. This type is needed for formats that cannot
-be represented by individual calendar date (@pxref{Calendar date items})
-and time of day (@pxref{Time of day items}) items due to ambiguity.
-
address@hidden
-# ISO 8601 extended date and time of day format
-1972-09-24T20:02:00,000000-0500
address@hidden example
-
@cindex ISO 8601 date and time of day format
@cindex date and time of day format, ISO 8601
-The ISO 8601 extended date and time of day format is an ISO
-8601 date, a @samp{T} character separator, followed by an ISO 8601 time
-of day.
+The ISO 8601 date and time of day extended format consists of an ISO
+8601 date, a @samp{T} character separator, and an ISO 8601 time of
+day. This format is also recognized if the @samp{T} is replaced by a
+space.
+In this format, the time of day should use 24-hour notation.
+Fractional seconds are allowed, with either comma or period preceding
+the fraction. ISO 8601 fractional minutes and hours are not
+supported. Typically, hosts support nanosecond timestamp resolution;
+excess precision is silently discarded.
+
+Here are some examples:
+
address@hidden
+2012-09-24T20:02:00.052-0500
+2012-12-31T23:59:59,999999999+1100
+1970-01-01 00:00Z
address@hidden example
@node Day of week items
@section Day of week items
--
1.7.11.7
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH] doc: improve ISO 8601 discussion,
Paul Eggert <=