ovos-date-parser

ovos-date-parser is a comprehensive library for multilingual date and time parsing, extraction, and formatting, designed to handle a range of human-readable date, time, and duration expressions.

Features

Date and Time Extraction: Extract specific dates and times from natural language phrases in various languages.
Duration Parsing: Parse phrases that indicate a span of time, such as "two hours and fifteen minutes."
Friendly Time Formatting: Format time for human-friendly output, supporting both 12-hour and 24-hour formats.
Relative Time Descriptions: Generate relative descriptions (e.g., "tomorrow," "in three days") for given dates.
Multilingual Support: Includes extraction and formatting methods for multiple languages, such as English, Spanish, French, German, and more.

Installation

pip install ovos-date-parser

Languages Supported

ovos-date-parser supports a wide array of languages, each with its own set of methods for handling natural language time expressions.

✅ - supported
❌ - not supported
🚧 - imperfect placeholder, usually a language agnostic implementation or external library

Parse

Language	`extract_duration`	`extract_datetime`
az	✅	✅
ca	✅	✅
cs	✅	✅
da	✅	✅
de	✅	✅
en	✅	✅
es	✅	✅
gl	✅	🚧
eu	❌	✅
fa	✅	✅
fr	❌	✅
hu	❌	🚧
it	❌	✅
nl	✅	✅
pl	✅	✅
pt	✅	✅
ru	✅	✅
sv	✅	✅
uk	✅	✅

💡 If a language is not implemented for extract_datetime then dateparser will be used as a fallback

Format

Language	`nice_date` `nice_date_time` `nice_day` `nice_weekday` `nice_month` `nice_year` `get_date_strings`	`nice_time`	`nice_relative_time`	`nice_duration`
az	✅	✅	🚧	✅
ca	✅	✅	🚧	✅
cs	✅	✅	🚧	✅
da	✅	✅	🚧	✅
de	✅	✅	🚧	✅
en	✅	✅	🚧	✅
es	✅	✅	🚧	✅
gl	✅	✅	🚧	✅
eu	✅	✅	✅	✅
fa	✅	✅	🚧	✅
fr	✅	✅	🚧	✅
hu	✅	✅	🚧	✅
it	✅	✅	🚧	✅
nl	✅	✅	🚧	✅
pl	✅	✅	🚧	✅
pt	✅	✅	🚧	✅
ru	✅	✅	🚧	✅
sv	✅	✅	🚧	✅
sl	✅	❌	🚧	✅
uk	✅	✅	🚧	✅

Usage

Date and Time Extraction

Extract specific dates and times from a phrase. This function identifies date-related terms in natural language and returns both the datetime object and any remaining text.

from ovos_date_parser import extract_datetime

result = extract_datetime("Meet me next Friday at 3pm", lang="en")
print(result)  # (datetime object, "at 3pm")

Duration Extraction

Identify duration phrases in text and convert them into a timedelta object. This can parse common human-friendly duration expressions like "30 minutes" or "two and a half hours."

from ovos_date_parser import extract_duration

duration, remainder = extract_duration("It will take about 2 hours and 30 minutes", lang="en")
print(duration)  # timedelta object
print(remainder)  # "about"

Formatting Time

Generate a natural-sounding time format suitable for voice or display in different languages, allowing customization for speech or written text.

from ovos_date_parser import nice_time
from datetime import datetime

dt = datetime.now()
formatted_time = nice_time(dt, lang="en", speech=True, use_24hour=False)
print(formatted_time)  # "three o'clock"

Relative Time Descriptions

Create relative phrases for describing dates and times in relation to the current moment or a reference datetime.

from ovos_date_parser import nice_relative_time
from datetime import datetime, timedelta

relative_time = nice_relative_time(datetime.now() + timedelta(days=1), datetime.now(), lang="en")
print(relative_time)  # "tomorrow"

Documentation

API reference — every public function and its parameters
Language notes — per-language behaviour and known gaps
Adding a language — implementation guide
examples/ — runnable example scripts

Related Projects

ovos-number-parser - for handling numbers
ovos-lang-parser - for handling languages
ovos-color-parser - for handling colors

License

This project is licensed under the Apache 2.0 License

Download files

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

Source Distribution

ovos_date_parser-0.16.0a1.tar.gz (191.9 kB view details)

Uploaded Jul 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ovos_date_parser-0.16.0a1-py3-none-any.whl (217.7 kB view details)

Uploaded Jul 16, 2026 Python 3

File details

Details for the file ovos_date_parser-0.16.0a1.tar.gz.

File metadata

Download URL: ovos_date_parser-0.16.0a1.tar.gz
Upload date: Jul 16, 2026
Size: 191.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for ovos_date_parser-0.16.0a1.tar.gz
Algorithm	Hash digest
SHA256	`d35b0f31c04fcd22154758d5677629eb1bfff752010ca754fdc876d8a2e974d8`
MD5	`125fc709ca2437202cdbe7a83810a94f`
BLAKE2b-256	`5e19f9de2533ac598b2d66bb1076c55f686c99601ab2d33d0124780ae1f8bec3`

See more details on using hashes here.

File details

Details for the file ovos_date_parser-0.16.0a1-py3-none-any.whl.

File metadata

Download URL: ovos_date_parser-0.16.0a1-py3-none-any.whl
Upload date: Jul 16, 2026
Size: 217.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for ovos_date_parser-0.16.0a1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3fb9c294b21d5c5e21734de9223fdade016140016d1702e85fb2d594299f9c9c`
MD5	`738700dadeeee7fca088324e531774fd`
BLAKE2b-256	`96d0749024477b2a0eec9887a02ab7cefd8b9ef109494704771c511dbd97e6d2`