1
2[//000000001]: # (clock\_iso8601 \- Date/Time Utilities)
3[//000000002]: # (Generated from file 'iso8601\.man' by tcllib/doctools with format 'markdown')
4[//000000003]: # (clock\_iso8601\(n\) 0\.1 tcllib "Date/Time Utilities")
5
6<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
7href="../../../toc.md">Table Of Contents</a> &#124; <a
8href="../../../../index.md">Keyword Index</a> &#124; <a
9href="../../../../toc0.md">Categories</a> &#124; <a
10href="../../../../toc1.md">Modules</a> &#124; <a
11href="../../../../toc2.md">Applications</a> ] <hr>
12
13# NAME
14
15clock\_iso8601 \- Parsing ISO 8601 dates/times
16
17# <a name='toc'></a>Table Of Contents
18
19  - [Table Of Contents](#toc)
20
21  - [Synopsis](#synopsis)
22
23  - [Description](#section1)
24
25  - [Bugs, Ideas, Feedback](#section2)
26
27  - [Category](#category)
28
29# <a name='synopsis'></a>SYNOPSIS
30
31package require Tcl 8\.5
32package require clock::iso8601 ?0\.1?
33
34[__::clock::iso8601 parse\_date__ *date* *options\.\.\.*](#1)
35[__::clock::iso8601 parse\_time__ *time* *options\.\.\.*](#2)
36
37# <a name='description'></a>DESCRIPTION
38
39This package provides functionality to parse dates and times in ISO 8601 format\.
40
41  - <a name='1'></a>__::clock::iso8601 parse\_date__ *date* *options\.\.\.*
42
43    This command parses an ISO8601 date string in an unknown variant and returns
44    the given date/time in seconds since epoch\.
45
46    The acceptable options are __\-base__, __\-gmt__, __\-locale__, and
47    __\-timezone__ of the builtin command __clock scan__\.
48
49  - <a name='2'></a>__::clock::iso8601 parse\_time__ *time* *options\.\.\.*
50
51    This command parses a full ISO8601 timestamp string \(date and time\) in an
52    unknown variant and returns the given time in seconds since epoch\.
53
54    The acceptable options are __\-base__, __\-gmt__, __\-locale__, and
55    __\-timezone__ of the builtin command __clock scan__\.
56
57# <a name='section2'></a>Bugs, Ideas, Feedback
58
59This document, and the package it describes, will undoubtedly contain bugs and
60other problems\. Please report such in the category *clock::iso8601* of the
61[Tcllib Trackers](http://core\.tcl\.tk/tcllib/reportlist)\. Please also report
62any ideas for enhancements you may have for either package and/or documentation\.
63
64When proposing code changes, please provide *unified diffs*, i\.e the output of
65__diff \-u__\.
66
67Note further that *attachments* are strongly preferred over inlined patches\.
68Attachments can be made by going to the __Edit__ form of the ticket
69immediately after its creation, and then using the left\-most button in the
70secondary navigation bar\.
71
72# <a name='category'></a>CATEGORY
73
74Text processing
75