Pendulum 0.8.0 is out: Improved ISO 8601 parsing and more

Pendulum 0.8.0 is now out.

It is mostly a deprecation notification release before the first stable release and it also improves the parsing of ISO 8601 strings.

For the full list of changes, see the Change Log

New Features

New on() and at() methods

These methods replace the with_date() and with_time() methods which are now deprecated.

>>> import pendulum
>>> from datetime import time, date

>>> dt = pendulum.now()

>>> dt.on(1975, 5, 21).at(22, 32, 5).to_datetime_string()
'1975-05-21 22:32:05'

New strict keyword argument for parse()

A new strict keyword argument has been added to parse() in order to get the exact type matching the parsed string.

>>> import pendulum

>>> pendulum.parse('2012-05-03', strict=True)
# <Date [2012-05-03]>

>>> pendulum.parse('12:04:23', strict=True)
# <Time [12:04:23]>

Ability to pass the length of the range() method

It is now possible to give the length of the gap for the range() method on the Period class.

>>> import pendulum

>>> start = pendulum.Pendulum(2000, 1, 1)
>>> end = pendulum.Pendulum(2000, 1, 10)

>>> period = pendulum.period(start, end)

>>> for dt in period.range('days', 2):
>>>     print(dt)

'2000-01-01T00:00:00+00:00'
'2000-01-03T00:00:00+00:00'
'2000-01-05T00:00:00+00:00'
'2000-01-07T00:00:00+00:00'
'2000-01-09T00:00:00+00:00'

New datetime() method on the Timezone class

You can now get a normalized datetime object directly from a Timezone by using the datetime() method:

>>> import pendulum

>>> tz = pendulum.timezone('Europe/Paris')
>>> dt = tz.datetime(2013, 3, 31, 2, 30)
>>> dt.isoformat()
'2013-03-31T03:30:00+02:00'

Changes

Improved parsing of ISO 8601 strings.

The library now supports parsing most of the ISO 8601 strings:

Datetime

Date

Ordinal day

Week number

Time

When passing only time information the date will default to today.

Deprecations

• with_date() and with_time() are deprecated. Use on() and at() instead.
• create_from_date() and create_from_time() are deprecated. Use create() instead.