Skip to main content

A few conveniences to do with dates and times.

Project description

A few conveniences to do with dates and times.

Latest release 20230210:

  • Drop Python 2 support.
  • Make timezones mandatory where previously they were assumed.

There are some other PyPI modules providing richer date handling than the stdlib datetime module. This module mostly contains conveniences used in my other code; you're welcome to it, but it does not pretend to be large or complete.

Function datetime2unixtime(dt)

Convert a timezone aware datetime to a UNIX timestamp.

Function isodate(when=None, dashed=True)

Return a date in ISO8601 YYYY-MM-DD format, or YYYYMMDD if not dashed.

Modern Pythons have a datetime.isoformat method, you use that.

Function localdate2unixtime(d)

Convert a localtime date into a UNIX timestamp.

Class tzinfoHHMM(datetime.tzinfo)

tzinfo class based on +HHMM / -HHMM strings.

Function unixtime2datetime(unixtime, *, tz: datetime.tzinfo)

Convert a a UNIX timestamp to a datetime in the timezone tz.

Class UNIXTimeMixin

A mixin for classes with a .unixtime attribute, a float storing a UNIX timestamp.

Release Log

Release 20230210:

  • Drop Python 2 support.
  • Make timezones mandatory where previously they were assumed.

Release 20210306: Initial release, used by cs.sqltags.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cs.dateutils-20230210.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

cs.dateutils-20230210-py3-none-any.whl (3.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page