BULK Time namespace
Thierry Technologies
pierre@nothos.net
binary
This specification describes a BULK serialization of time informations.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD
NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as
described in RFC 2119.
Literal numerical values are provided in decimal or hexadecimal as appropriate.
Hexadecimal literals are prefixed with 0x to distinguish them
from decimal literals.
BULK bytes sequences and expressions are described with the same conventions than used in
the BULK 1.0 specification
The time namespace is an official namespace identified by the UUID (BULK, "Time passed, which,
basically, is its job."). It provides a standard way to serialize some formats used to
express time, mainly those from ISO 8601.
This specification defines the following types:
a sequence of type Int, Int Int or Int Int Int
a sequnce of one or more expressions, all of which MUST be of type
Int, except the last which can also be of type Float
Note that BULK serializations of single points in time are notably bigger than a string
containing their ISO 8601 notation. Such times SHOULD be serialized as offsets against an
epoch (like Julian date or Unix time), except where simplicity of implementation is
wanted.
0x1 (mnemonic: calendar )
( calendar Int123 )
This serialize dates like 1999, 2001-06 or 2013-08-06.
Types: ISOTime, Date
0x2 (mnemonic: weekdate )
( weekdate Int123 )
This serialize dates like 1979, 1987-W06 or 2012-W52-1.
Types: ISOTime, Date
0x3 (mnemonic: ordinal )
( ordinal Int Int )
This serialize dates like 2004-006 or 2000-366.
Types: ISOTime, Date
0x4 (mnemonic: time-of-day )
( time-of-day {components}:IntsF )
This serialize times like 22, 13:45 or 06:34:57,3. {components} MUST contain from 1 to 3
expressions.
Types: ISOTime, ISOTimeOfDay
0x5 (mnemonic: point )
( point Date ISOTimeOfDay )
This serialize dates like 2005-W34-7T19:45.
Type: ISOTime
0x6 (mnemonic: zulu )
( zulu ISOTime )
This serialize times like 2005-W34-7T19:45Z or 11:53:23Z.
Type: ISOTime
0x7 (mnemonic: offset )
( offset ISOTimeOfDay ISOTime )
This serialize times like 2005-W34-7T19:45+02 or 11:53-01:30.
Type: ISOTime
years
months
days
hours
minutes
seconds
weeks
All durations have the same shape: ( Ref {components}:IntsF
). { components} must contain from 1 to respectively 6, 5, 4, 3, 2, 1 and 1
expressions.
Type: ISODuration
0xF (mnemonic: interval )
( interval ISOTime ISOTime )
( interval ISOTime ISODuration )
( interval ISODuration ISOTime )
( interval ISODuration )
Type: Interval
0x10 (mnemonic: repeat )
( interval Int Interval )
( interval Interval )
0x11 (mnemonic: julian )
( julian {num}:Number )
It serializes the Julian Day Number (if {num} has type Int) or the Julian Date (if {num}
has type Float).
0x12 (mnemonic: unix-time )
( unix-time Number )
It serializes the number of seconds since or until the Unix epoch (with microsecond or
nanosecond precision if the number has type Float).
0x13 (mnemonic: tng-stardate )
( tng-stardate Int Int )
It serializes a stardate following the conventions of Star Trek: The Next Generation and
following series.
0x14 (mnemonic: anno-mundi )
( anno-mundi Int123 )
It serializes a date in the hebrew calendar.
0x15 (mnemonic: anno-hegirae )
( anno-hegirae Int123 )
It serializes a date in the islamic calendar.
Key words for use in RFCs to Indicate Requirement Levels
Harvard University
sob@harvard.edu
Binary Uniform Language Kit 1.0
Thierry Technologies
pierre@nothos.net
ISO 8601:2004 Data elements and interchange formats -- Information interchange -- Representation
of dates and times