This release is a pre-release and may not be stable for production use.
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 | โ | โ |
| oc | โ | โ |
| pl | โ | โ |
| pt | โ | โ |
| ro | โ | โ |
| ru | โ | โ |
| sv | โ | โ |
| uk | โ | โ |
๐ก If a language is not implemented for
extract_datetimethen dateparser will be used as a fallback
Format
| Language | nice_datenice_date_timenice_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 | โ | โ | ๐ง | โ |
| oc | โ | โ | ๐ง | โ |
| pl | โ | โ | ๐ง | โ |
| pt | โ | โ | ๐ง | โ |
| ro | โ | โ | ๐ง | โ |
| 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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ovos_date_parser-0.18.1a1.tar.gz.
File metadata
- Download URL: ovos_date_parser-0.18.1a1.tar.gz
- Upload date:
- Size: 219.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69bd945caa83071c7601cd2a0423ad4fccf6b321c50489bb9c0f12783980e95e
|
|
| MD5 |
8fb97eca6d30e43172322ad4833db59f
|
|
| BLAKE2b-256 |
a7717762ff6bca07be718bb23fad96eedea7cbb8f87e3f5463f75aa769b962df
|
File details
Details for the file ovos_date_parser-0.18.1a1-py3-none-any.whl.
File metadata
- Download URL: ovos_date_parser-0.18.1a1-py3-none-any.whl
- Upload date:
- Size: 243.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb93cb3fd9453b86d51584e73a9c9623482b3b8b0e58d3b1fa9a9108f6fb49d5
|
|
| MD5 |
b5dd97ba80c02adcf5d9d524e7038186
|
|
| BLAKE2b-256 |
2406fa5affeabe1094466f0c7e6f2ee03d0981f3fdd136294ace8be1531fb948
|
