Parse date-time-string, and return (values universal-time fraction).
Parsable date-time-format: ISO8601, W3CDTF, RFC3339, RFC822, RFC2822, RFC5322, asctime, RFC850, RFC1036.

cl-date-time-parser

Last modified: 2014-05-18 14:39:27 tkych

version 0.1.03 (beta)


CL-Date-Time-Parser
===================

> In general, an implementation should be conservative in its sending
> behavior, and liberal in its receiving behavior.
> [RFC791: Internet Protocol](http://tools.ietf.org/html/rfc791)


There are a lot of formats to specify the date and time on the Web.
For example:

 * "Thu, 23 Jul 2013 19:42:23 GMT" (RFC1123),
 * "Thu Jul 23 19:42:23 2013" (asctime),
 * "Thursday, 23-Jul-13 19:42:23 GMT" (RFC1036),
 * "2013-07-23T19:42:23Z" (RFC3339),
 * "20130723T194223Z" (ISO8601:2004), etc.

The goal of cl-date-time-parser is to hide the difference between
date-time formats, and enable to manage date and time as the one date-time format
([Universal Time](http://www.lispworks.com/documentation/HyperSpec/Body/25_adb.htm)).

Function `parse-date-time` parses date-time-string, and return universal-time and fraction.
Parsable date-time formats are:

 * RFC822 (RFC1123, RFC2822, RFC5322),
 * asctime,
 * RFC850 (RFC1036),
 * ISO8601 (1988, 2000, 2004, except for no-year format), W3CDTF (subset of ISO 8601),
 * RFC3339.

In addition, `parse-date-time` can liberally parse the above formats with little broken.


Depends-on
----------

 * [alexandria](http://common-lisp.net/project/alexandria/)
 * [anaphora](http://common-lisp.net/project/anaphora/)
 * [split-sequence](http://www.cliki.net/split-sequence)
 * [cl-ppcre](http://weitz.de/cl-ppcre/)
 * [local-time](http://common-lisp.net/project/local-time/)
 * [parse-float](https://github.com/soemraws/parse-float)


Installation
------------

#### cl-test-grid results:

 - http://common-lisp.net/project/cl-test-grid/library/cl-date-time-parser.html


##### Auto:

 0. CL-REPL> `(ql:quickload :cl-date-time-parser)`


##### Manual:

 0. SHELL$   `git clone https://github.com/tkych/cl-date-time-parser`
 1. CL-REPL> `(push #p"/path-to-cl-date-time-parser/cl-date-time-parser/" asdf:*central-registry*)`
 2. CL-REPL> `(ql:quickload :cl-date-time-parser)` or `(asdf:load-system :cl-date-time-parser)`


Examples
--------

    (parse-date-time "Thu, 23 Jul 2013 19:42:23 GMT") ;RFC 1123
    => 3583597343, 0

    (parse-date-time "Thu Jul 23 19:42:23 2013") ;asctime
    => 3583597343, 0

    (parse-date-time "Thursday, 23-Jul-13 19:42:23 GMT") ;RFC 1036
    => 3583597343, 0

    (parse-date-time "2013-07-23T19:42:23Z") ;RFC 3339
    => 3583597343, 0

    (parse-date-time "20130723T194223Z") ;ISO 8601
    => 3583597343, 0

    (parse-date-time "Thu, 23 Jul 2013 19:42:23 JST")
    => 3583564943, 0

    (parse-date-time "2013-07-23T19:42:23+09:00")
    => 3583564943, 0

    (parse-date-time "23 Jul 13 19:42:23 +0900")
    => 3583564943, 0

    (parse-date-time "Thu Jul 23 19:42:23 JST 2013")
    => 3583564943, 0

    (parse-date-time "2013-07-23T19:42:23.45Z")
    => 3583597343, 0.45

    (parse-date-time "2013-01-01")
    => 3565987200, 0

    (parse-date-time "2013")
    => 3565987200, 0

    (parse-date-time "1 Jan 13")
    => 3565987200, 0

    (parse-date-time "2003-12-31T25:14:55Z") ;broken hours
    => 3281908495, 0
    (parse-date-time "2004-01-01T01:14:55Z")
    => 3281908495, 0

    (parse-date-time "2003-12-31T10:61:55Z") ;broken minuits
    => 3281857315, 0
    (parse-date-time "2003-12-31T11:01:55Z")
    => 3281857315, 0

    (parse-date-time "2003-12-31T10:14:61Z") ;broken seconds
    => 3281854501, 0
    (parse-date-time "2003-12-31T10:15:01Z")
    => 3281854501, 0

    (parse-date-time ";3-12-31T10:15:01Z") ;broken two-digit-years c.f. rfc3339, 3.
    => 3597473701, 0
    (parse-date-time "2013-12-31T10:15:01Z")
    => 3597473701, 0


For further examples, please see Eval-Test in date-time-parser.lisp


Manual
------

#### [Function] PARSE-DATE-TIME _date-time-string_ => _universal-time_, _fraction_

Parse _date-time-string_, and return _universal-time_ and _fraction_.
_date-time-string_ must represent the date-time after 1900-01-01T00:00:00Z.

Parsable Formats:

 * RFC822 Genus: RFC822, RFC1123, RFC2822, RFC5322, asctime, RFC850 (RFC1036).
 * ISO8601 Genus: ISO8601(:1988, :2000 and :2004. except for no-year format), W3CDTF, RFC3339.
 * Broken format: The above formats with little broken.


Reference
---------

 * RFC822 (Internet Message Format) Genus:
   * [RFC 822: Standard for the Format of Arpa Internet Text Messages](http://tools.ietf.org/html/rfc822)
   * [RFC 1123: Requirements for Internet Hosts -- Application and Support](http://tools.ietf.org/html/rfc1123)
   * [RFC 2822: Internet Message Format](http://tools.ietf.org/html/rfc2822)
   * [RFC 5322: Internet Message Format](http://tools.ietf.org/html/rfc5322)
     * [errata for RFC 5322](http://www.rfc-editor.org/errata_search.php?rfc=5322)
   * [RFC 850: Standard for Interchange of USENET Messages](http://tools.ietf.org/html/rfc850)
   * [RFC 1036: Standard for Interchange of USENET Messages](http://tools.ietf.org/html/rfc1036)
   * [asctime format](http://en.cppreference.com/w/c/chrono/asctime)

 * ISO8601 (Timestamp) Genus:
   * [ISO 8601:1988, 2000, 2004](http://www.iso.org/iso/home/standards/iso8601.htm)
   * [W3CDTF: Date and Time Formats](http://www.w3.org/TR/1998/NOTE-datetime-19980827)
   * [RFC 3339: Date and Time on the Internet: Timestamps](http://tools.ietf.org/html/rfc3339)
     * [errata for RFC 3339](http://www.rfc-editor.org/errata_search.php?rfc=3339)


Author, License, Copyright
--------------------------

 - Takaya OCHIAI  <#.(reverse "moc.liamg@lper.hcykt")>

 - MIT License

 - Copyright (C) 2013 Takaya OCHIAI


cl-date-time-parser

Upstream URL

Author

License

cl-date-time-parser

Version:

License:

Authors:

Dependencies:

Dependencies (6)

Dependents (1)