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> | <a 7href="../../../toc.md">Table Of Contents</a> | <a 8href="../../../../index.md">Keyword Index</a> | <a 9href="../../../../toc0.md">Categories</a> | <a 10href="../../../../toc1.md">Modules</a> | <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