Skip to main content

Module datetime

Module datetime 

Source
Expand description

§Date and time values

The decoded date/time value kinds: a calendar date, a date-time, and a time.

IcalDate (RFC 5545 3.3.4, YYYYMMDD) backs date-valued properties and IcalTime (RFC 5545 3.3.12, HHMMSS with an optional Z suffix) backs bare time values.

IcalDateTime (RFC 5545 3.3.5, YYYYMMDDTHHMMSS with an optional Z suffix or a companion TZID parameter) backs DTSTART / DTEND / DTSTAMP and friends.

All three are kept as their raw text rather than decoded into calendar fields: the grammars carry timezone-dependent and reduced-precision forms whose meaning depends on companion parameters, so decoding here would risk a lossy round-trip.

Callers that need calendar semantics parse the string themselves.

Structs§

IcalDate
A decoded date value (YYYYMMDD), kept as its raw text.
IcalDateTime
A decoded date-time value (YYYYMMDDTHHMMSS, optional Z or TZID), kept as its raw text.
IcalDateTimeList
A decoded comma-separated list of date-ish values, each kept as raw text.
IcalTime
A decoded time value (HHMMSS, optional Z), kept as its raw text.