sickdt 0.1.0

Robust, automated timezone handling.

ISO 8601-compliant timestamp strings.

Unix epoch seconds.

Only depends on Python standard library.

Uses built-in data types: datetime, float, str.

A datetime object represents an instant, a particular point in time. A snapshot of the universe. It doesn’t matter what was the timezone, DST mode, the user’s calendar, nor their locale.

A datetime on its own isn’t human-readable. If you need to show it to the user, you need to provide the timezone or locale.

All datetime objects must be timezone-aware.

When in need of string timestamps, use ISO 8601 with milliseconds and Zulu time.

When in need of numerical timestamps, use a float for UNIX epoch seconds in UTC.

This must be easy to integrate with existing codebase. No custom data types over stdlib.

Inspired by the design choices of NSDate.

Arrow. Requires a total buy-in, you have to switch to using their datatypes.