Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the cl-date-time-parser Reference Manual, version 0.1.3, generated automatically by Declt version 3.0 "Montgomery Scott" on Tue Dec 22 12:13:01 2020 GMT+0.
| • Introduction | What cl-date-time-parser is all about | |
| • Systems | The systems documentation | |
| • Files | The files documentation | |
| • Packages | The packages documentation | |
| • Definitions | The symbols documentation | |
| • Indexes | Concepts, functions, variables and data types |
Last modified: 2014-05-18 14:39:27 tkych
version 0.1.03 (beta)
In general, an implementation should be conservative in its sending behavior, and liberal in its receiving behavior. RFC791: Internet Protocol
There are a lot of formats to specify the date and time on the Web. For example:
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).
Function parse-date-time parses date-time-string, and return universal-time and fraction.
Parsable date-time formats are:
In addition, parse-date-time can liberally parse the above formats with little broken.
(ql:quickload :cl-date-time-parser)git clone https://github.com/tkych/cl-date-time-parser(push #p"/path-to-cl-date-time-parser/cl-date-time-parser/" asdf:*central-registry*)(ql:quickload :cl-date-time-parser) or (asdf:load-system :cl-date-time-parser)(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
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 (Internet Message Format) Genus:
ISO8601 (Timestamp) Genus:
Takaya OCHIAI <#.(reverse "moc.liamg@lper.hcykt")>
MIT License
Copyright (C) 2013 Takaya OCHIAI
Next: Files, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
| • The cl-date-time-parser system |
Takaya OCHIAI <tkych.repl@gmail.com>
MIT License
Parse date-time-string, and return (values universal-time fraction).
Parsable date-time-format: ISO8601, W3CDTF, RFC3339, RFC822, RFC2822, RFC5322, asctime, RFC850, RFC1036.
0.1.3
cl-date-time-parser.asd (file)
date-time-parser.lisp (file)
Files are sorted by type and then listed depth-first from the systems components trees.
| • Lisp files |
| • The cl-date-time-parser.asd file | ||
| • The cl-date-time-parser/date-time-parser.lisp file |
Next: The cl-date-time-parser/date-time-parser․lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
cl-date-time-parser.asd
cl-date-time-parser (system)
Previous: The cl-date-time-parser․asd file, Up: Lisp files [Contents][Index]
cl-date-time-parser (system)
date-time-parser.lisp
parse-date-time (function)
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
| • The cl-date-time-parser package |
date-time-parser.lisp (file)
date-time-parser
common-lisp
parse-date-time (function)
Definitions are sorted by export status, category, package, and then by lexicographic order.
| • Exported definitions | ||
| • Internal definitions |
Next: Internal definitions, Previous: Definitions, Up: Definitions [Contents][Index]
| • Exported functions |
Previous: Exported definitions, Up: Exported definitions [Contents][Index]
Parse DATE-TIME-STRING, and return (values UNIVERSAL-TIME FRACTION).
DATE-TIME-STRING must represent the date-time after 1900-01-01T00:00:00Z.
Parsable Formats:
* RFC822 Genus: RFC822 (RFC1123, RFC2822, RFC5322), RFC850 (RFC1036) and asctime.
* ISO8601 Genus: ISO 8601 (:1988, :2000 and :2004. except for no-year format),
W3CDTF, RFC3339.
* Broken format: The above formats with little broken.
Examples:
* (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
For more examples, see Eval-Test in date-time-parser.lisp
date-time-parser.lisp (file)
Previous: Exported definitions, Up: Definitions [Contents][Index]
| • Internal constants | ||
| • Internal special variables | ||
| • Internal functions |
Next: Internal special variables, Previous: Internal definitions, Up: Internal definitions [Contents][Index]
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
Next: Internal functions, Previous: Internal constants, Up: Internal definitions [Contents][Index]
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
Previous: Internal special variables, Up: Internal definitions [Contents][Index]
Return offset for the time-zone-abbrev. If not find offset, return NIL.
date-time-parser.lisp (file)
date-time-parser.lisp (file)
Return T if YEAR is a leap year, otherwise NIL. c.f. RFC3339, (Appendix C. Leap Years)
date-time-parser.lisp (file)
date-time-parser.lisp (file)
Parse DATE-TIME-STRING with ISO8601, W3CDTF or RFC3339 format,
and return (values UNIVERSAL-TIME FRACTION).
Reference:
* ISO8601:1988, 2000, 2004
– http://www.iso.org/iso/home/standards/iso8601.htm
* W3CDTF – http://www.w3.org/TR/1998/NOTE-datetime-19980827
* RFC3339 – http://tools.ietf.org/html/rfc3339
date-time-parser.lisp (file)
Parse DATE-TIME-STRING with RFC822 (RFC1123, RFC2822, RFC5322),
RFC850 (RFC1036) or asctime format, and return
(values UNIVERSAL-TIME FRACTION).
Reference:
* RFC822 – http://tools.ietf.org/html/rfc822
* RFC2822 – http://tools.ietf.org/html/rfc2822
* RFC5322 – http://tools.ietf.org/html/rfc5322
* RFC850 – http://tools.ietf.org/html/rfc850
* RFC1036 – http://tools.ietf.org/html/rfc1036
* asctime – http://en.cppreference.com/w/c/chrono/asctime
date-time-parser.lisp (file)
date-time-parser.lisp (file)
Previous: Definitions, Up: Top [Contents][Index]
| • Concept index | ||
| • Function index | ||
| • Variable index | ||
| • Data type index |
Next: Function index, Previous: Indexes, Up: Indexes [Contents][Index]
| Jump to: | C F L |
|---|
| Jump to: | C F L |
|---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
| Jump to: | C F G L M P Y |
|---|
| Jump to: | C F G L M P Y |
|---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
| Jump to: | *
+
C S |
|---|
| Jump to: | *
+
C S |
|---|
Previous: Variable index, Up: Indexes [Contents][Index]
| Jump to: | C P S |
|---|
| Jump to: | C P S |
|---|