Skip to main content

SQLAlchemy type to store aware datetime values

Project description


This package provides a drop-in replacement of SQLAlchemy’s built-in DateTime type with timezone=True option enabled. Although SQLAlchemy’s built-in DateTime type provides timezone=True option, since some vendors like SQLite and MySQL don’t provide timestamptz data type, the option doesn’t make any effect on these vendors.

UtcDateTime type is equivalent to the built-in DateTime with timezone=True option enabled on vendors that support timestamptz e.g. PostgreSQL, but on SQLite or MySQL, it shifts all datetime.datetime values to UTC offset before store them, and returns always aware datetime.datetime values through result sets.

Long story short, UtcDateTime does:

  • take only aware datetime.datetime,
  • return only aware datetime.datetime,
  • never take or return naive datetime.datetime,
  • ensure timestamps in database always to be encoded in UTC, and
  • work as you’d expect.

A SQLAlchemy helper function, utcnow(), is provided as an alternative to for generating UtcDateTime values on the server. For example: Column('time', UtcDateTime(), default=utcnow()).

Written by Hong Minhee at Spoqa, and distributed under MIT license.



Released on September 24, 2021.

  • Add cache_ok flag on UtcDateTime to supress Pandas warnings. [#14 by derekderie]


Released on September 24, 2021.

  • Add milliseconds to SQLite datetimes. [#12 by Giovanni Santini]
  • Add support for newer python versions. (3.7, 3.8, 3.9) [#12 by Giovanni Santini]


Released on May 7, 2021.

  • Add py.typed file to the package to be compatible with PEP-561. [#10 by Dima Boger]


Released on November 13, 2020.

  • Ensured always returning the datetime with UTC timezone. [#8 by Eduard Christian Dumitrescu]


Released on January 25, 2018.

  • Dropped support of older Python versions: 2.6, 3.2, and 3.3. [#2 by George Leslie-Waksman]
  • Added sqlalchemy_utc.utcnow() function as an alternative to for generating UtcDateTime values on the database server. [#4 by George Leslie-Waksman]


First version. Released on June 22, 2016.

Download files

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

Files for SQLAlchemy-Utc, version 0.14.0
Filename, size File type Python version Upload date Hashes
Filename, size SQLAlchemy_Utc-0.14.0-py2.py3-none-any.whl (6.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size SQLAlchemy-Utc-0.14.0.tar.gz (5.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page