Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the rfc3339-timestamp Reference Manual, version 0.1.3, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 12:31:22 2018 GMT+0.
• Introduction: | What rfc3339-timestamp 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 |
RFC3339-timestamp is relaxed implementation of RFC3339 timestamps using cl-yacc for parsing and a very simple timestamp class for keeping track of fractions of a second and offset if you need it to survive a decode/encode round trip. A known limitation is that fractions of a second are limited to 10 digits. The parser implementation is quite relaxed about what it passes. For instance a single space is allowed in place of a T for date time seperation. Z or time offset is not needed at all and when left out the parser will assume the timestamp is UTC+00:00. Fractions are of course optional although that is also true per the RFC. Another limitation is that dates prior to 1900-01-01 01:00:00 cannot be represented because that is when universal time which is used internally starts. If you don't care for the relaxed mode of the parser you can make it stricter by pushing :rfc3339-strict-parser to your *features* and recompile. This will make the parser only accept true RFC3339 timestamps. The other kind of timestamp that will be parsed if :rfc3339-strict-parser is not in *features* is the specific format used by xml-rpc. Which to my understanding is YYYYMMDDTHH:MM:SS.
Next: Files, Previous: Introduction, Up: Top [Contents][Index]
The main system appears first, followed by any subsystem dependency.
• The rfc3339-timestamp system: |
Peter Stiernström <peter@stiernstrom.se>
BSD
A Common Lisp implementation of timestamps as defined by RFC3339
0.1.3
yacc
rfc3339-timestamp.asd (file)
Files are sorted by type and then listed depth-first from the systems components trees.
• Lisp files: |
• The rfc3339-timestamp.asd file: | ||
• The rfc3339-timestamp/src/package.lisp file: | ||
• The rfc3339-timestamp/src/timestamp.lisp file: | ||
• The rfc3339-timestamp/src/parser.lisp file: |
Next: The rfc3339-timestamp/src/package<dot>lisp file, Previous: Lisp files, Up: Lisp files [Contents][Index]
rfc3339-timestamp.asd
rfc3339-timestamp (system)
Next: The rfc3339-timestamp/src/timestamp<dot>lisp file, Previous: The rfc3339-timestamp<dot>asd file, Up: Lisp files [Contents][Index]
rfc3339-timestamp (system)
src/package.lisp
Next: The rfc3339-timestamp/src/parser<dot>lisp file, Previous: The rfc3339-timestamp/src/package<dot>lisp file, Up: Lisp files [Contents][Index]
src/package.lisp (file)
rfc3339-timestamp (system)
src/timestamp.lisp
Previous: The rfc3339-timestamp/src/timestamp<dot>lisp file, Up: Lisp files [Contents][Index]
src/timestamp.lisp (file)
rfc3339-timestamp (system)
src/parser.lisp
Next: Definitions, Previous: Files, Up: Top [Contents][Index]
Packages are listed by definition order.
• The rfc3339 package: |
src/package.lisp (file)
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 special variables: | ||
• Exported functions: | ||
• Exported generic functions: | ||
• Exported conditions: | ||
• Exported classes: |
Next: Exported functions, Previous: Exported definitions, Up: Exported definitions [Contents][Index]
src/timestamp.lisp (file)
Next: Exported generic functions, Previous: Exported special variables, Up: Exported definitions [Contents][Index]
When supplying utc-time you must make sure that you also supply a correct offset. For UTC+00:00 the offset is 0. For UTC-01:00 the offset would be -3600 and for UTC+01:00 the offset would be 3600.
Should you supply an offset or set *default-offset* to a value which does not translates to whole hours and seconds and thus can not be represented using a time offset of just hours and minutes we will break horribly so that you notice it.
src/timestamp.lisp (file)
src/parser.lisp (file)
Next: Exported conditions, Previous: Exported functions, Up: Exported definitions [Contents][Index]
Represents the fractions that can not be represented using whole seconds of universal time.
src/timestamp.lisp (file)
src/timestamp.lisp (file)
src/timestamp.lisp (file)
src/timestamp.lisp (file)
Represent the offset in seconds relative to UTC. UTC+1 should be an offset of -3600
src/timestamp.lisp (file)
This is the timestamp such as it should look according to
RFC3339. Unfortunately it doesn’t work for xml-rpc which uses someones
ugly arbitrary idea of iso8601 and thus doesn’t allow for fractions or
timezones.
src/timestamp.lisp (file)
src/timestamp.lisp (file)
The timestamp as a universal time value with the
accuracy of on second. This should be in UTC and the offset should
go in the offset slot.
src/timestamp.lisp (file)
src/timestamp.lisp (file)
This is the version of iso8601 that is used at xmlrpc.com/spec and that ruby seems to like. We use local-time because when using xml-rpc the time zone should be part of the api documentation rather than the timestamp which is a bit limiting...
src/timestamp.lisp (file)
Next: Exported classes, Previous: Exported generic functions, Up: Exported definitions [Contents][Index]
src/parser.lisp (file)
condition (condition)
:fault-string
fault-string-of (generic function)
(setf fault-string-of) (generic function)
Previous: Exported conditions, Up: Exported definitions [Contents][Index]
src/timestamp.lisp (file)
standard-object (class)
The timestamp as a universal time value with the
accuracy of on second. This should be in UTC and the offset should
go in the offset slot.
:utc-time
utc-time-of (generic function)
(setf utc-time-of) (generic function)
Represents the fractions that can not be represented using whole seconds of universal time.
:fraction
0
fraction-of (generic function)
(setf fraction-of) (generic function)
Represent the offset in seconds relative to UTC. UTC+1 should be an offset of -3600
:offset
offset-of (generic function)
(setf offset-of) (generic function)
Previous: Exported definitions, Up: Definitions [Contents][Index]
• Internal special variables: | ||
• Internal functions: | ||
• Internal generic functions: |
Next: Internal functions, Previous: Internal definitions, Up: Internal definitions [Contents][Index]
src/parser.lisp (file)
Next: Internal generic functions, Previous: Internal special variables, Up: Internal definitions [Contents][Index]
src/parser.lisp (file)
src/parser.lisp (file)
src/parser.lisp (file)
src/timestamp.lisp (file)
src/parser.lisp (file)
src/parser.lisp (file)
src/parser.lisp (file)
src/parser.lisp (file)
src/timestamp.lisp (file)
src/parser.lisp (file)
src/parser.lisp (file)
Previous: Internal functions, Up: Internal definitions [Contents][Index]
src/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: | F L R |
---|
Jump to: | F L R |
---|
Next: Variable index, Previous: Concept index, Up: Indexes [Contents][Index]
Jump to: | (
C D F G L M O P R T U X |
---|
Jump to: | (
C D F G L M O P R T U X |
---|
Next: Data type index, Previous: Function index, Up: Indexes [Contents][Index]
Jump to: | *
F O S U |
---|
Jump to: | *
F O S U |
---|
Previous: Variable index, Up: Indexes [Contents][Index]
Jump to: | C M P R S T |
---|
Jump to: | C M P R S T |
---|