sickdt

Opinionated wrapper over the built-in datetime module. Exposes a subset of just the right functionality to avoid common gotchas with dates in Python.

Yo, these datetimes are sick!

~anonymous

Features

• 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.

Driving Principles

• 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.

Similar Projects

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