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.

Documentation

Documentation can be found here.

Features

  • Generic parsing of dates in English, Spanish, Dutch, Russian and several other languages 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 or UTC offsets like: 'August 14, 2015 EST', 'July 4, 2013 PST', '21 July 2013 10:15 pm +0500'.

  • Support for non-Gregorian calendar systems. See Supported Calendars.

  • 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 relies on following libraries in some ways:

  • dateutil’s module parser to parse the translated dates.

  • PyYAML for reading language and configuration files.

  • jdatetime to convert Jalali dates to Gregorian.

  • umalqurra to convert Hijri dates to Gregorian.

Supported languages

  • Arabic

  • Belarusian

  • Chinese

  • Czech

  • Dutch

  • English

  • Filipino

  • Finnish

  • French

  • German

  • Indonesian

  • Italian

  • Persian

  • Polish

  • Portuguese

  • Romanian

  • Russian

  • Spanish

  • Thai

  • Turkish

  • Ukrainian

  • Vietnamese

Supported Calendars

  • Gregorian calendar.

  • Persian Jalali calendar. For more information, refer to Persian Jalali Calendar.

  • Hijri/Islamic Calendar. For more information, refer to Hijri Calendar.

    >>> from dateparser.calendars.jalali import JalaliParser
    >>> JalaliParser(u'جمعه سی ام اسفند ۱۳۸۷').get_date()
    datetime.datetime(2009, 3, 20, 0, 0)
    
    >>> from dateparser.calendars.hijri import HijriCalendar
    >>> HijriCalendar(u'17-01-1437 هـ 08:30 مساءً').get_date()
    {'date_obj': datetime.datetime(2015, 10, 30, 20, 30), 'period': 'day'}
    

History

0.3.3 (2016-02-29)

New features:

  • Finnish language support.

Improvements:

  • Faster parsing with switching to regex module.

  • RETURN_AS_TIMEZONE_AWARE setting to return tz aware date object.

  • Fixed conflicts with month/weekday names similarity across languages.

0.3.2 (2016-01-25)

New features:

  • Added Hijri Calendar support.

  • Added settings for better control over parsing dates.

  • Support to convert parsed time to the given timezone for both complete and relative dates.

Improvements:

  • Fixed problem with caching datetime.now in FreshnessDateDataParser.

  • Added month names and week day names abbreviations to several languages.

  • More simplifications for Russian and Ukranian languages.

  • Fixed problem with parsing time component of date strings with several kinds of apostrophes.

0.3.1 (2015-10-28)

New features:

  • Support for Jalali Calendar.

  • Belarusian language support.

  • Indonesian language support.

Improvements:

  • Extended support for Russian and Polish.

  • Fixed bug with time zone recognition.

  • Fixed bug with incorrect translation of “second” for Portuguese.

0.3.0 (2015-07-29)

New features:

  • Compatibility with Python 3 and PyPy.

Improvements:

  • languages.yaml data cleaned up to make it human-readable.

  • Improved Spanish date parsing.

0.2.1 (2015-07-13)

  • Support for generic parsing of dates with UTC offset.

  • Support for Filipino dates.

  • Improved support for French and Spanish dates.

0.2.0 (2015-06-17)

  • Easy to use parse function

  • 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.3.3.tar.gz (71.6 kB view hashes)

Uploaded Source

Built Distribution

dateparser-0.3.3-py2.py3-none-any.whl (43.0 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