.. image:: http://delorean.readthedocs.org/en/latest/_static/delorean.png

Delorean: Time Travel Made Easy

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, and generating datetimes.

Delorean stands on the shoulders of giants: the standard library's zoneinfo <https://docs.python.org/3/library/zoneinfo.html>_ and dateutil <https://dateutil.readthedocs.io/>_

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:

.. code-block:: python

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

est = ZoneInfo('US/Eastern')
d = datetime.now(timezone.utc)
d = d.astimezone(est)
return d

Now lets warm up the delorean:

.. code-block:: python

from delorean import Delorean

d = Delorean()
d = d.shift('US/Eastern')
return d

Look at you looking all fly. This was just a test drive: check out out what else delorean can help with in the documentation <http://delorean.readthedocs.org/en/latest/>_.