zulu 0.2.0

Links

• Project: https://github.com/dgilland/zulu

• Documentation: https://zulu.readthedocs.io

• PyPI: https://pypi.python.org/pypi/zulu/

• TravisCI: https://travis-ci.org/dgilland/zulu

Features

• Supported on Python 2.7 and Python 3.4+

• All datetime objects converted and stored as UTC.

• Parses ISO8601 formatted strings and POSIX timestamps by default.

• Timezone representation applied only during string output formatting or when casting to native datetime object.

• Drop-in replacement for native datetime objects.

Quickstart

Install using pip:

pip install zulu

import zulu

zulu.now()
# <DateTime [2016-07-25T19:33:18.137493+00:00]>

dt = zulu.parse('2016-07-25T19:33:18.137493+00:00')
# <DateTime [2016-07-25T19:33:18.137493+00:00]>

dt.isoformat()
# '2016-07-25T19:33:18.137493+00:00'

dt.timestamp()
# 1469475198.137493

dt.naive
# datetime.datetime(2016, 7, 25, 19, 33, 18, 137493)

dt.datetime
# datetime.datetime(2016, 7, 25, 19, 33, 18, 137493, tzinfo=<UTC>)

dt.shift(hours=-5, minutes=10)
# <DateTime [2016-07-25T14:43:18.137493+00:00]>

dt.replace(hour=14, minute=43)
# <DateTime [2016-07-25T14:43:18.137493+00:00]>

dt.start_of('day')
# <DateTime [2016-07-25T00:00:00+00:00]>

dt.end_of('day')
#<DateTime [2016-07-25T23:59:59.999999+00:00]>

dt.span('hour')
# (<DateTime [2016-07-25T19:00:00+00:00]>, <DateTime [2016-07-25T19:59:59.999999+00:00]>)

list(zulu.DateTime.range('hour', dt, dt.shift(hours=4)))
# [<DateTime [2016-07-25T19:33:18.137493+00:00]>,
#  <DateTime [2016-07-25T20:33:18.137493+00:00]>,
#  <DateTime [2016-07-25T21:33:18.137493+00:00]>,
#  <DateTime [2016-07-25T22:33:18.137493+00:00]>]

list(zulu.DateTime.span_range('minute', dt, dt.shift(minutes=4)))
# [(<DateTime [2016-07-25T19:33:00+00:00]>, <DateTime [2016-07-25T19:33:59.999999+00:00]>),
#  (<DateTime [2016-07-25T19:34:00+00:00]>, <DateTime [2016-07-25T19:34:59.999999+00:00]>),
#  (<DateTime [2016-07-25T19:35:00+00:00]>, <DateTime [2016-07-25T19:35:59.999999+00:00]>),
#  (<DateTime [2016-07-25T19:36:00+00:00]>, <DateTime [2016-07-25T19:36:59.999999+00:00]>)]

Why Zulu?

Why zulu instead of native datetimes:

• Zulu has extended datetime features such as parse(), format(), shift(), and pytz timezone support.

• Parses ISO8601 and timestamps by default without any extra arguments.

• Easier to reason about DateTime objects since they are only ever UTC datetimes.

• Clear delineation between UTC and other time zones where timezone representation is only applicable for display or conversion to native datetime.

• Supports more string parsing/formatting options using Unicode date patterns as well as strptime/strftime directives.

Why zulu instead of Arrow:

• Zulu is a drop-in replacement for native datetimes (inherits from datetime.datetime). No need to convert using arrow.datetime when you need a datetime (zulu is always a datetime).

• Stricter parsing to avoid silent errors. For example, one might expect arrow.get('02/08/1987', 'MM/DD/YY') to fail (input does not match format) but it gladly returns <Arrow [2019-02-08T00:00:00+00:00]> whereas zulu.parse('02/08/1987', '%m/%d/%y') throws zulu.parser.ParseError: Value "02/08/1987" does not match any format in ['%m/%d/%y'].

• Avoids timezone/DST shifting bugs by only dealing with UTC datetimes when applying timedeltas or performing other calculations.

• Supports strptime/strftime as well as Unicode date patterns for string parsing/formatting.

For more details, please see the full documentation at https://zulu.readthedocs.io.

Changelog