fast-parse-time

Extract dates and times from text. Fast, deterministic, zero cost.

Why?

LLMs can parse dates, but they're slow, expensive, and non-deterministic. This library gives you:

• Sub-millisecond performance - Process thousands of documents per second
• Zero API costs - No per-request charges
• Deterministic results - Same input always produces same output
• Simple API - One function call, everything extracted

Install

pip install fast-parse-time

Usage

from fast_parse_time import parse_dates

text = "Meeting on 04/08/2024 to discuss issues from 5 days ago"
result = parse_dates(text)

# Explicit dates found in text
print(result.explicit_dates)
# [ExplicitDate(text='04/08/2024', date_type='FULL_EXPLICIT_DATE')]

# Relative time expressions
print(result.relative_times)
# [RelativeTime(cardinality=5, frame='day', tense='past')]

# Convert to Python datetime
for time_ref in result.relative_times:
    print(time_ref.to_datetime())
    # datetime.datetime(2025, 11, 14, ...)

What It Extracts

Explicit dates:

"Event on 04/08/2024"          → 04/08/2024 (full date)
"Meeting scheduled for 3/24"   → 3/24 (month/day)
"Copyright 2024"               → 2024 (year only)
"Ambiguous: 4/8"               → 4/8 (flagged as ambiguous)

Relative times:

"5 days ago"                   → 5 days (past)
"last couple of weeks"         → 2 weeks (past)
"30 minutes ago"               → 30 minutes (past)

Examples

Parse everything at once

result = parse_dates("Report from 04/08/2024 covering issues from last week")

result.explicit_dates  # ['04/08/2024']
result.relative_times  # [RelativeTime(cardinality=1, frame='week', tense='past')]

Just get dates

from fast_parse_time import extract_explicit_dates

dates = extract_explicit_dates("Event on 04/08/2024 or maybe 3/24")
# {'04/08/2024': 'FULL_EXPLICIT_DATE', '3/24': 'MONTH_DAY'}

Convert to datetime objects

from fast_parse_time import resolve_to_datetime

datetimes = resolve_to_datetime("Show me data from 5 days ago")
# [datetime.datetime(2025, 11, 14, ...)]

Features

• Multiple date formats: 04/08/2024, 3/24, 2024-06-05
• Multiple delimiters: /, -, .
• Relative time expressions: "5 days ago", "last week", "couple of months ago"
• Ambiguity detection: Flags dates like 4/8 that could be April 8 or August 4
• Time frame support: seconds, minutes, hours, days, weeks, months, years

Documentation

• Complete API Reference
• System Boundaries - Design decisions and limitations
• Examples

Performance

Typical extraction takes < 1ms per document. No network calls, no model inference, pure Python.

License

MIT - See LICENSE for details.

Author

Craig Trim - craigtrim@gmail.com

---

Report Issues | API Docs | PyPI