Skip to main content

Date parsing library designed to parse dates from HTML pages

Project description

travis build status pypi downloads per day pypi version

dateparser provides modules to easily parse localized dates in almost any string formats commonly found on web pages.

Features

  • Generic parsing of dates in English, Spanish, Dutch, Russian and several other langauges and formats.

  • Generic parsing of relative dates like: '1 min ago', '2 weeks ago', '3 months, 1 week and 1 day ago'.

  • Generic parsing of dates with time zones abbreviations like: 'August 14, 2015 EST', 'July 4, 2013 PST'.

  • Extensive test coverage.

Usage

The most straightforward way is to use the dateparser.parse function, that wraps around most of the functionality in the module.

Relative Dates

>>> parse('1 hour ago')
datetime.datetime(2015, 5, 31, 23, 0)
>>> parse(u'Il ya 2 heures')  # French (2 hours ago)
datetime.datetime(2015, 5, 31, 22, 0)
>>> parse(u'1 anno 2 mesi')  # Italian (1 year 2 months)
datetime.datetime(2014, 4, 1, 0, 0)
>>> parse(u'yaklaşık 23 saat önce')  # Turkish (23 hours ago)
datetime.datetime(2015, 5, 31, 1, 0)
>>> parse(u'Hace una semana')  # Spanish (a week ago)
datetime.datetime(2015, 5, 25, 0, 0)
>>> parse(u'2小时前')  # Chinese (2 hours ago)
datetime.datetime(2015, 5, 31, 22, 0)

Dependencies

dateparser translates non-english dates to English and uses dateutil module 'parser' to parse the translated date.

Also, it requires PyYAML for its language detection module to work.

Limitations

dateparser at this point does not support generic parsing of dates with fixed UTC offsets. This restricts its ability to reliably parse time zone aware dates since the use of abbreviated time zones as a sole designator of time zones is not recommended.

Read Wikipedia Time Zone article for more information.

History

0.2.0 (2015-06-17)

  • Languages definitions using YAML.

  • Using translation based approach for parsing non-english languages. Previously, dateutil.parserinfo was used for language definitions.

  • Better period extraction.

  • Improved tests.

  • Added a number of new simplifications for more comprehensive generic parsing.

  • Improved validation for dates.

  • Support for Polish, Thai and Arabic dates.

  • Support for pytz timezones.

  • Fixed building and packaging issues.

0.1.0 (2014-11-24)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dateparser-0.2.0.tar.gz (53.1 kB view hashes)

Uploaded Source

Built Distribution

dateparser-0.2.0-py2.py3-none-any.whl (31.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page