Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tkych/cl-date-time-parser

Parse date-time-string, liberally.
https://github.com/tkych/cl-date-time-parser

Last synced: 2 months ago
JSON representation

Parse date-time-string, liberally.

Lists

README 

        
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 "[email protected]")>



 - MIT License



 - Copyright (C) 2013 Takaya OCHIAI