time

IROX-TIME

A date & time library that aims for ease of use using static compile-time types based on the Proleptic Gregorian Calendar.

Goals:

• Provide type-safe, correct, easy conversions between Epochs
• Provide type-safe, correct, easy conversions between the Unix Epoch and the associated Gregorian Date and Time

Non-goals:

• Handle strange edge cases like:
  • Old Style Dates and the various 10-14 days that don't exist.
  • Year Zero
  • Julian Leap Year Error
• Handle Time Zones and Daylight Savings Time

Eventually:

• Leap Seconds and UTC Proper

Module Structure

• time - Contains the base Time struct, describing a standard Hours/minutes/seconds framework.
• datetime - Contains UTCDateTime structs, describing a Date with a Time
• epoch - Contains Epoch, UnixEpoch, GPSEpoch, and others, providing the datum anchor for timestamps UnixTimestamp, GPSTimestamp, etc.
• format - Date & Time Formatters & Parsers
  • iso8601 - ISO8601 Date Formats
  • rfc3339 - RFC3339 Date Formats, a slight variation on ISO8601
• gregorian - Contains Date and Month, that describe a gregorian calendar date.

Features

• std - adds 'std' support:
  • UnixTimestamp::now() -> UnixTimestamp
  • UnixTimestamp::elapsed() -> Duration
  • UTCDateTime::now() ->UTCDateTime
  • impls of std::error::Error on errors