NAME

       clock_iso8601 - Parsing ISO 8601 dates/times

SYNOPSIS

       package require Tcl  8.5

       package require clock::iso8601  ?0.1?

       ::clock::iso8601 parse_date date options...

       ::clock::iso8601 parse_time time options...

_________________________________________________________________________________________________

DESCRIPTION

       This package provides functionality to parse dates and times in ISO 8601 format.

       ::clock::iso8601 parse_date date options...
              This  command  parses  an ISO8601 date string in an unknown variant and returns the
              given date/time in seconds since epoch.

              The acceptable options are -base, -gmt,  -locale,  and  -timezone  of  the  builtin
              command clock scan.

       ::clock::iso8601 parse_time time options...
              This  command  parses a full ISO8601 timestamp string (date and time) in an unknown
              variant and returns the given time in seconds since epoch.

              The acceptable options are -base, -gmt,  -locale,  and  -timezone  of  the  builtin
              command clock scan.

DATE FORMATS

       The commands accept the following 23 date formats:

              (year)-(month)-(day)
              (year)(month)(day)
              (year)-(day in year)
              (year)(day in year)
              (year in century)-(month)-(day)
              (year)-(month)Day defaults to the 1st of the month
              (year in century)(month)(day)
              (year in century)-(day in year)
              (year in century)(day in year)
              --(month)-(day)Year defaults to the current year
              --(month)(day)Year defaults to the current year
              --(day in year)Year defaults to the current year
              ---(day)          Year defaults to the current year, month to current month
              (fiscal year)-W(week)-(wday)
              (fiscal year)W(week)-(wday)
              (fiscal year in century)-W(week)-(wday)
              (fiscal year in century)W(week)(wday)
              (fiscal year)-W(week)Weekday defaults to monday
              (fiscal year)W(week)Weekday defaults to monday
              -W(week)-(wday)Year defaults to current fiscal year
              -W(week)(wday)Year defaults to current fiscal year
              (wday)    Year defaults to current fiscal year, week to current week
              (year)    Month defaults to january, day to 1st of the month

       The possible parts/fields in the above, and their meanings, are:

       year   Year with century, 4 digits

       month  Month in year, 2 digits

       day    Day in month, 2 digits.

       year in century
              Year without century, 2 digits

       day in year
              Day in year, 3 digits

       fiscal year
              ISO 8601 fiscal year with century, 4 digits

       fiscal year in century
              ISO 8601 fiscal year without century, 2 digits

       week   ISO 8601 week number

       wday   Week day, 1 digit, Monday (1) to Sunday (7,0)

BUGS, IDEAS, FEEDBACK

       This  document,  and  the  package  it  describes, will undoubtedly contain bugs and other
       problems.  Please report such in  the  category  clock::iso8601  of  the  Tcllib  Trackers
       [http://core.tcl.tk/tcllib/reportlist].  Please also report any ideas for enhancements you
       may have for either package and/or documentation.

       When proposing code changes, please provide unified diffs, i.e the output of diff -u.

       Note further that attachments are strongly preferred over inlined patches. Attachments can
       be  made  by going to the Edit form of the ticket immediately after its creation, and then
       using the left-most button in the secondary navigation bar.

CATEGORY

       Text processing