sickdt 0.1.0

Opinionated wrapper over the built-in ``datetime`` module.

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.