nr-date 1.1.0

Fast date parsing with timezone offset support.

nr.date

This package provides a fast parser for fixed format date strings with support for timezone offsets. The goal of this package is to

1. bring support for timezone offsets to Python 2.7
2. be faster than dateutil.parser.parse()

You can control the regex backend with the PYTHON_NR_DATE_REGEX_BACKEND environment variable. The default is re. You can use this variable to make it use the regex module instead.

Currently supported format options are:

• %Y – 4 digit year
• %m – 2 digit month
• %d – 2 digit day
• %H – 2 digit hour
• %M – 2 digit minute
• %S – 2 digit second
• %f – arbitrary precision milliseconds
• %z – timezone offset ([+-]\d\d:?\d\d offset or Z for UTC)

The date formats are extensible by using the register_format_option() function or creating a new FormatOptionSet.

API

BaseFormatOption()

Base class for format options.

FormatOption(char, dest, regex, parser, render)

Useful class for creating a new format options.

TimezoneFormatOption()

Special format option implementation for matching timezone offset.

FormatOptionSet()

Represents a set of BaseFormatOption objects. Use the create_date_format() method to create a DateFormat object from this set and a format string.

DateFormat(string, option_set=None)

Creates a new parser and formatter for dates from a template string. It is recommendable to use FormatOptionSet.create_date_format() instead to make use of caching.

DateFormatSet(name, formats)

A collection of DateFormat objects that can be parsed successively until a first match is found. The format() method will use the first format in the set.

root_option_set

A global FormatOptionSet.

register_format_option()

Add a new format option to the root_option_set. This is the same as calling root_option_set.add().

parse_date(string, fmt)

Parses the date string using the specified fmt into a datetime.datetime object.

format_date(date, fmt)

Formats the date using the specified fmt into a string.

create_format_set(name, formats)

Creates a new DateFormatSet with the specified formats.

ISO_8601

JAVA_OFFSET_DATETIME

Benchmarks

TODO

Future

• Vendor dateutil.tz module?

Changelog

v1.1.0 (2019-04-16)

• Fix microsecond (%f) formatting
• Fix parsing of timezone offset with colon (%z)
• Use pkgutil instead of pkg_resources namespace packages

v1.0.0 (2019-04-06)

• Initial release