Skip to main content

A tiny library for working with UTC time.

Project description

It Should Be Easier

The current Python landscape doesn’t make it simple enough to use timezone aware timestamps.

It’d be nice if datetime.datetime.now() gave you a timezone-aware datetime in your current timezone, but it doesn’t.

You’d expect datetime.datetime.utcnow() to at least be timezone-aware, right? No. There’s no tzinfo on the datetime you get back from that function.

The pytz package has comprehensive support for time zones, and if you need to do something complicated, you should use that. But you don’t always need to do something complicated. Sometimes you just want UTC.

This package provides syntactic sugar around simple UTC handling that I’ve rewritten in too many times in past projects.

Usage

There is a now() function that does the right thing:

>>> import utc
>>> utc.now()
datetime.datetime(2013, 8, 30, 16, 51, 50, 316963, tzinfo=<UTC>)

And a datetime constructor that is UTC by default:

>>> utc.datetime(1900, 1, 1, 13, 25)
datetime.datetime(1900, 1, 1, 13, 25, tzinfo=<UTC>)

And a time constructor too:

>>> utc.time(13, 26, 36)
datetime.time(13, 26, 36, tzinfo=<UTC>)

That is all.

Project details


Release history Release notifications

History Node

0.0.3

This version
History Node

0.0.2

History Node

0.0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
utc-0.0.2.tar.gz (1.8 kB) Copy SHA256 hash SHA256 Source None Mar 5, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page