Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

Drop-in replacement for timezone aware datetime objects

Project description

Build Status


Module providing a timezone aware datetime.datetime compatible object. Supports CPython 2.6 - 3.5 and PyPy.


datetime.datetime objects aren’t aware by default. New projects should always use timezone aware datetime.datetime objects, but the Python standard library doesn’t make that easy. AwareDatetime is here to help!

You may also have existing code that needs to become timezone aware and migrating code to become timezone aware is tricky. Using AwareDatetime will help you track what code has been migrated to support timezone.


A drop-in replacement for datetime.datetime that always provide timezone aware objects.

Example Usage

>>> from awaredatetime import AwareDatetime
>>> AwareDatetime(2016, 1, 1)
AwareDatetime(2016, 1, 1, 0, 0, tzinfo=<UTC>)
>>> import datetime
>>> AwareDatetime.from_datetime(datetime.datetime(2016, 1, 1))
AwareDatetime(2016, 1, 1, 0, 0, tzinfo=<UTC>)


Not implemented since times with a timezone don’t make sense. e.g. What’s the expected behavior for coverting 24:00:00+00:00 to positive UTC offset?


The only dependency is pytz. We recommend that you use the latest version of pytz, but this package will not force that upon you.

Migrating Existing Code

Similar work

  • datetime_tz - Another timezone aware drop-in replacement for the datetime module, but overrides more datetime behavior

Project details

Download files

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

Files for awaredatetime, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size awaredatetime-0.0.1-py2.py3-none-any.whl (6.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page