J.T. Conklin sent the following to me privately and I made some
tiny adjustment. Any comments before I push it?
We both admit that it's not complete, but trying to describe
in text what the grammar does is a losing game.
Suggestions for improvements are most welcome.
>From 617d664ec6befeccc6a0332d9aba6065076b3ff2 Mon Sep 17 00:00:00 2001
From: "J.T. Conklin" <j...@acorntoolworks.com>
Date: Sun, 4 Sep 2011 23:11:23 +0200
Subject: [PATCH] parse-datetime: document the newly accepted format
* doc/parse-datetime.texi (Combined date and time of day items):
New section.
---
ChangeLog | 6 ++++++
doc/parse-datetime.texi | 24 ++++++++++++++++++++++++
2 files changed, 30 insertions(+), 0 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 176aff9..2f64d74 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2011-09-04 J.T. Conklin <j...@acorntoolworks.com>
+
+ parse-datetime: document the newly accepted format
+ * doc/parse-datetime.texi (Combined date and time of day items):
+ New section.
+
2011-09-06 Bruno Haible <br...@clisp.org>
acl: Fix a test failure on newer Solaris 10 with ZFS.
diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi
index b159f96..1e52f0d 100644
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -51,6 +51,7 @@ Date input formats
* Calendar date items:: 19 Dec 1994.
* Time of day items:: 9:20pm.
* Time zone items:: @sc{est}, @sc{pdt}, @sc{gmt}.
+* 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.
@@ -76,6 +77,7 @@ General date syntax
@item calendar date items
@item time of day items
@item time zone items
+@item combined date and time of day items
@item day of the week items
@item relative items
@item pure numbers.
@@ -311,6 +313,28 @@ Time zone items
(@pxref{Specifying time zone rules}).
+@node Combined date and time of day items
+@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.
+
+@example
+1972-09-24T20:02:00,000000-0500 # @sc{iso} 8601 extended date and time of day
format
+@end example
+
+@cindex @sc{iso} 8601 date and time of day format
+@cindex date and time of day format, @sc{iso} 8601
+
+The @sc{iso} 8601 extended date and time of day format is an @sc{iso}
+8601 date, a @samp{T} character separator, followed by an @sc{iso} 8601 time
+of day.
+
+
@node Day of week items
@section Day of week items
--
1.7.7.rc0.362.g5a14
