How to Parse Datetime Strings in Python with Dateparser

Do not assume that a naive result is UTC. If the source omits a zone, configure the source zone or require the sender to include one.

Rank #3

Python Programming Language: a QuickStudy Laminated Reference Guide

$8.95

Buy on Amazon

Handle relative and incomplete dates

Relative expressions need a reference time

Words such as “tomorrow” are evaluated relative to a reference moment. For repeatable jobs, tests, and audits, provide RELATIVE_BASE rather than allowing the current clock to change the result.

from datetime import datetime
from dateparser import parse

reference = datetime(2024, 3, 15, 9, 0)
value = parse(
    "tomorrow",
    settings={"RELATIVE_BASE": reference},
)
if value is None:
    raise ValueError("Could not resolve relative date")

print(value)

Partial dates need a missing-component policy

For input containing only a month and year, the missing day is an assumption rather than information supplied by the user. The PREFER_DAY_OF_MONTH setting accepts current, first, or last. Choose one deliberately and record that choice in your data model.

from dateparser import parse

value = parse(
    "March 2024",
    settings={"PREFER_DAY_OF_MONTH": "first"},
)
if value is None:
    raise ValueError("Could not parse partial date")

Choose between parse and DateDataParser

parse() is convenient for isolated values. If you repeatedly process strings from one source, the documented DateDataParser class can be a better fit: an instance caches detected languages and prioritizes them on subsequent parses. That avoids repeating language-detection work conceptually and keeps source-specific configuration together.

from dateparser.date import DateDataParser

parser = DateDataParser(languages=["en"])
result = parser.get_date_data("March 15, 2024 2:30 PM")
if result is None:
    raise ValueError("Could not parse date")

print(result)

Use a separate parser instance when different feeds have different language assumptions. Do not share one implicit language policy across unrelated sources.

Rank #4

Sale

Learning Python: Powerful Object-Oriented Programming

$53.66

Buy on Amazon

Control language detection

Dateparser can use a custom detect_languages_function when your application already has a language detector. The documentation warns that detection can fail on short strings, particularly numeric dates. If the language is known, pass it directly. Otherwise combine your detector with DEFAULT_LANGUAGES as a fallback.

Practical decision table

The documentation notes that optional langdetect integration is available and that fastText support has been removed. Treat detection as a convenience, not as proof that a short string was interpreted correctly.

Validate flexible results

Flexible parsing can accept text you did not intend to treat as a date. The official overview recommends valid date strings without unrelated words or numbers and advises providing known languages or locales where possible. Add application-level checks after parsing.

from datetime import datetime, timezone
from dateparser import parse

raw = "March 15, 2024 2:30 PM"
value = parse(
    raw,
    settings={
        "TIMEZONE": "UTC",
        "RETURN_AS_TIMEZONE_AWARE": True,
    },
)

if value is None:
    raise ValueError(f"Unparseable date: {raw!r}")
if value.tzinfo is None:
    raise ValueError("Expected a timezone-aware datetime")
if value.year < 2000:
    raise ValueError("Date is outside the accepted business range")
if value > datetime.now(timezone.utc):
    raise ValueError("Future dates are not allowed for this field")

The year and future-date rules above are application examples; replace them with the constraints your domain actually requires. Dateparser determines an interpretation, not whether that interpretation is acceptable for your business process.

Best Value

Python Programming for Beginners: The Complete Guide to Mastering Python in 7 Days with Hands-On Exercises – Top Secret Coding Tips to Get an Unfair Advantage and Land Your Dream Job!

$24.99

Buy on Amazon

Troubleshoot common failures

The result is None

• Cause: The string contains unrelated words, malformed numbers, or a format the parser cannot interpret.
• Fix: Normalize the source, remove unrelated text, provide date_formats, and check the result before using it.

The day and month are swapped

• Cause: The numeric input is ambiguous and locale precedence or the default MDY order was used.
• Fix: Set DATE_ORDER and, when necessary, PREFER_LOCALE_DATE_ORDER=False.

The datetime is naive when you expected an aware value

• Cause: No timezone policy was supplied, or the selected settings do not request an aware result.
• Fix: Set TIMEZONE, use RETURN_AS_TIMEZONE_AWARE=True where appropriate, and inspect tzinfo.

“Tomorrow” changes between runs

• Cause: Relative parsing uses the current time by default.
• Fix: Supply a fixed RELATIVE_BASE for tests, replayable jobs, and audit trails.

A month-year value gets an unexpected day

• Cause: The day is missing and a preference determines the fill value.
• Fix: Set PREFER_DAY_OF_MONTH to current, first, or last according to your requirements.

Language detection fails on short input

• Cause: A short numeric string provides little language evidence.
• Fix: Pass the known language or locale directly, or combine a custom detector with DEFAULT_LANGUAGES.

Reliability and performance considerations

There are no documented benchmark figures in the current references, so choose configuration for correctness rather than an assumed speed claim. For repeated parsing from one source, use DateDataParser so detected languages are cached and prioritized. For heterogeneous feeds, separate source policies and validate each result.

• Log the original string and the settings used when a parse is rejected.
• Keep timezone and date-order policy in configuration, not hidden defaults.
• Test representative localized, ambiguous, relative, partial, and offset-bearing inputs.
• Use fixed relative bases in automated tests.
• Check both the value and its tzinfo before persisting timestamps.

Or skip the browser setup

If your workflow also needs screenshots of documentation, reports, or rendered date output, ScreenshotNeo provides a one-request website screenshot API. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; bot checks, blank pages, failed loads, timeouts, and cache hits are not billed, and response headers identify the page verdict and billing status. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.

Use the API documentation at https://screenshotneo.com/docs/ for all options.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

import requests

r = requests.get(
    "https://api.screenshotneo.com/v1/shot",
    params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"},
    timeout=90,
)
open("shot.webp", "wb").write(r.content)

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

The Free plan includes 1,000 screenshots per month with no card. Paid plans start at $5 for 3,000 screenshots, and every feature is included on every plan. Create a free ScreenshotNeo account.

Quick Recap

SaleBestseller No. 1

Python Crash Course, 3rd Edition: A Hands-On, Project-Based Introduction to Programming

$27.53

Bestseller No. 2

Python Programming for Beginners: The Complete Python Coding Crash Course - Boost Your Growth with an Innovative Ultra-Fast Learning Framework and Exclusive Hands-On Interactive Exercises & Projects

$24.90

Bestseller No. 3

Python Programming Language: a QuickStudy Laminated Reference Guide

$8.95

SaleBestseller No. 4

Learning Python: Powerful Object-Oriented Programming

$53.66

Bestseller No. 5

Python Programming for Beginners: The Complete Guide to Mastering Python in 7 Days with Hands-On Exercises – Top Secret Coding Tips to Get an Unfair Advantage and Land Your Dream Job!

$24.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.