Delorean: Time Travel Made Easy

datetime? Where we’re going, we don’t need datetime.

This document describes Delorean v0.3.1.

Delorean is the name of the car in the movie Back to the Future. The movie deals with a lot of time travel, hence the name Delorean as a module dealing with datetimes.

Delorean is a library for clearing up the inconvenient truths that arise dealing with datetimes in Python. Understanding that timing is a delicate enough of a problem delorean hopes to provide a cleaner less troublesome solution to shifting, manipulating, generating datetimes.

Delorean stands on the shoulders of giants pytz and dateutil

Delorean will provide natural language improvements for manipulating time, as well as datetime abstractions for ease of use. The overall goal is to improve datetime manipulations, with a little bit of software and philosophy.

Pretty much make you a badass, time traveller.

Getting Started

Here is the world without a flux capacitor at your side.:

from datetime import datetime
from pytz import timezone

EST = "US/Eastern"

d = datetime.utcnow()
utc = timezone(UTC)
est = timezone(EST)
d = utc.localize(d)
d = est.normalize(d)
return d

Now lets warm up the delorean:

from delorean import Delorean

EST = "US/Eastern"

d = Delorean(timezone=EST)
return d

Look at you looking all fly. This was just a test drive checkout out what else delorean can help with below.

Delorean is a library that provides easy and convenient datetime conversions in Python. Dealing with generating lists of datetimes, timezone shifting, and much more.


If you are having issues we would love to hear from you. Just hit me up. You can alternatively raise an issue here on Github.

Stay Informed

Fork me on GitHub