diff options
| author | J.T. Conklin <jtc@acorntoolworks.com> | 2011-09-04 23:11:23 +0200 |
|---|---|---|
| committer | Jim Meyering <meyering@redhat.com> | 2011-09-06 17:03:20 +0200 |
| commit | f8e2db8413d327570ba5b513231ab006c4d0dea9 (patch) | |
| tree | 59cbe3d3b5a8742c960fcde6fd732824d0244b30 /doc/parse-datetime.texi | |
| parent | 90a660caf9ee30220c474227a870b11b7e2c26df (diff) | |
| download | gnulib-f8e2db8413d327570ba5b513231ab006c4d0dea9.tar.gz | |
parse-datetime: document the newly accepted format
* doc/parse-datetime.texi (Combined date and time of day items):
New section.
Diffstat (limited to 'doc/parse-datetime.texi')
| -rw-r--r-- | doc/parse-datetime.texi | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/parse-datetime.texi b/doc/parse-datetime.texi index b159f9645c..5a54d2225c 100644 --- a/doc/parse-datetime.texi +++ b/doc/parse-datetime.texi @@ -51,6 +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:: @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 @@ many flavors of items: @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,29 @@ time stamps are interpreted using the rules of the default time zone (@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 +# ISO 8601 extended date and time of day format +1972-09-24T20:02:00,000000-0500 +@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 |