---
id: dateparser
version: "1.4.2"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# dateparser — Date parsing library designed to parse dates from HTML pages

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install dateparser
uv add dateparser
poetry add dateparser

## Description

.. Note that we use raw HTML in the header section because centering images and paragraphs is not supported in Github (https://github.com/github/markup/issues/163)



.. :changelog:

History
=======

1.4.2 (2026-08-04)
------------------

New features:

- Add an ``IGNORE_SURROUNDING_TEXT`` setting that, when enabled, retries
  parsing after ignoring the leading and trailing words the language does
  not recognize, so a date wrapped in extra text such as "Published on
  16/04/2019" is parsed (#1356)
- Add a ``strategy`` argument to ``search_dates()`` to choose the search
  strategy: the default ``"split"`` keeps the current behavior, while the
  new ``"ngram"`` strategy parses the longest sequences of tokens as dates
  for more predictable results on noisy text (#1351)

Fixes:

- Do not read a two-digit number as a year once a later component has been
  found in year-first date orders, so the day in Japanese dates such as
  "4月20日" is no longer consumed as the year (#1358)
- Parse ISO 8601 dates (those starting with a four-digit year) in month-day
  order even when an explicit day-first language such as ``it`` or ``fr`` is
  given, without needing to set...

## AI interpretation — verify before relying

Parses dates and times from text in multiple languages and formats, including relative expressions like "2 days ago" and ISO 8601 dates, with configurable locale and timezone handling.

Verdict: Production-ready date parser with strong maintenance (active, recent release), no known vulnerabilities, and permissive licensing. The low install friction and broad language support make it a solid choice for projects needing flexible date extraction from unstructured text.

[View on SkillFed](https://skillfed.io/packages/dateparser) · [View on PyPI](https://pypi.org/project/dateparser/)