Datetimeparser

<br /> <div align="center"> <h1 align="center">datetimeparser</h1> <p align="center"> A python parser library made for parsing english language into datetime objects <br /> <i> made with ❤️ by <a href="https://aridevelopment.de/">aridevelopment.de</a></i> <br /> <br /> <a href="https://github.com/aridevelopment-de/datetimeparser/issues">Report an issue</a> · <a href="https://github.com/aridevelopment-de/datetimeparser/issues">Request a new feature</a> </p> </div>

About The Project

Datetimeparser is a python library capable of parsing the english language into datetime objects.
It was created due to the lack of such library and need for it. We knew that there was dateutil but we wanted a more powerful parsing library.
Datetimeparser can even parse complex grammar and sentence structure.

Examples

Below you can find some examples of how datetimeparser can be used.

from datetimeparser import parse

print(parse("next 3 years and 2 months"))
# 2025-04-06 11:43:28

print(parse("begin of advent of code 2022"))
# 2022-12-01 06:00:00

print(parse("in 1 Year 2 months 3 weeks 4 days 5 hours 6 minutes 7 seconds"))
# 2023-05-01 17:59:52

print(parse("10 days and 2 hours after 3 months before christmas 2020"))
# 2020-10-05 02:00:00

Installation

Use pip to install the library:

$ pip install python-datetimeparser

Contributing

If you want to contribute to datetimeparser, please use feature branches. If possible, name them after an already opened issue (e.g. feature/131).
We highly appreciate everyone who wants to help our project!

List of Constants

<details> <summary>All Normal-Constants</summary> <details> <summary><code>christmas</code></summary> <ul> <li>xmas</li> </ul> </details><details> <summary><code>holy eve</code></summary> <ul> </ul> </details><details> <summary><code>silvester</code></summary> <ul> <li>new years eve</li> </ul> </details><details> <summary><code>eastern</code></summary> <ul> <li>easter</li> </ul> </details><details> <summary><code>nicholas</code></summary> <ul> <li>nicholas day</li> </ul> </details><details> <summary><code>halloween</code></summary> <ul> </ul> </details><details> <summary><code>april fools day</code></summary> <ul> <li>april fool day</li> </ul> </details><details> <summary><code>thanksgiving</code></summary> <ul> </ul> </details><details> <summary><code>saint patrick's day</code></summary> <ul> <li>saint patricks day</li> <li>st. patrick's day</li> <li>saint pt. day</li> <li>st patrick's day</li> <li>st patricks day</li> </ul> </details><details> <summary><code>valentines day</code></summary> <ul> <li>valentine</li> <li>valentine day</li> </ul> </details><details> <summary><code>summer end</code></summary> <ul> <li>end of summer</li> <li>end of the summer</li> </ul> </details><details> <summary><code>winter end</code></summary> <ul> <li>end of winter</li> <li>end of the winter</li> </ul> </details><details> <summary><code>spring end</code></summary> <ul> <li>end of spring</li> <li>end of the spring</li> </ul> </details><details> <summary><code>fall end</code></summary> <ul> <li>end of fall</li> <li>end of the fall</li> <li>autumn end</li> <li>end of autumn</li> <li>end of the autumn</li> </ul> </details><details> <summary><code>summer begin</code></summary> <ul> <li>summer</li> <li>begin of summer</li> <li>begin of the summer</li> </ul> </details><details> <summary><code>winter begin</code></summary> <ul> <li>winter</li> <li>begin of winter</li> <li>begin of the winter</li> </ul> </details><details> <summary><code>spring begin</code></summary> <ul> <li>spring</li> <li>begin of spring</li> <li>begin of the spring</li> </ul> </details><details> <summary><code>fall begin</code></summary> <ul> <li>fall</li> <li>begin of fall</li> <li>begin of the fall</li> <li>autumn begin</li> <li>autumn</li> <li>begin of autumn</li> <li>begin of the autumn</li> </ul> </details><details> <summary><code>morning</code></summary> <ul> <li>at morning</li> </ul> </details><details> <summary><code>evening</code></summary> <ul> <li>at evening</li> </ul> </details><details> <summary><code>lunchtime</code></summary> <ul> <li>lunch</li> </ul> </details><details> <summary><code>aoc begin</code></summary> <ul> <li>aoc</li> <li>begin of aoc</li> <li>begin of the aoc</li> <li>advent of code begin</li> <li>advent of code</li> <li>begin of advent of code</li> <li>begin of the advent of code</li> </ul> </details><details> <summary><code>aoc end</code></summary> <ul> <li>end of aoc</li> <li>end of the aoc</li> <li>advent of code end</li> <li>end of advent of code</li> <li>end of the advent of code</li> </ul> </details><details> <summary><code>end of year</code></summary> <ul> <li>the end of year</li> <li>the end of the year</li> <li>end of the year</li> </ul> </details><details> <summary><code>begin of year</code></summary> <ul> <li>the begin of year</li> <li>the begin of the year</li> <li>begin of the year</li> </ul> </details><details> <summary><code>infinity</code></summary> <ul> <li>inf</li> </ul> </details><details> <summary><code>today</code></summary> <ul> </ul> </details><details> <summary><code>tomorrow</code></summary> <ul> </ul> </details><details> <summary><code>yesterday</code></summary> <ul> </ul> </details><details> <summary><code>now</code></summary> <ul> <li>at the moment</li> <li>current time</li> <li>current time now</li> </ul> </details> </details> <br /> <details> <summary>All Day-Constants</summary> <details> <summary><code>morning</code></summary> <ul> </ul> </details><details> <summary><code>afternoon</code></summary> <ul> </ul> </details><details> <summary><code>evening</code></summary> <ul> </ul> </details><details> <summary><code>night</code></summary> <ul> </ul> </details><details> <summary><code>morning night</code></summary> <ul> </ul> </details><details> <summary><code>daylight change</code></summary> <ul> <li>daylight saving</li> <li>daylight saving time</li> </ul> </details><details> <summary><code>midnight</code></summary> <ul> </ul> </details><details> <summary><code>midday</code></summary> <ul> </ul> </details><details> <summary><code>dawn</code></summary> <ul> </ul> </details><details> <summary><code>dusk</code></summary> <ul> </ul> </details><details> <summary><code>sunrise</code></summary> <ul> </ul> </details><details> <summary><code>sunset</code></summary> <ul> </ul> </details><details> <summary><code>lunch</code></summary> <ul> <li>lunchtime</li> </ul> </details><details> <summary><code>dinner</code></summary> <ul> <li>dinnertime</li> </ul> </details><details> <summary><code>breakfast</code></summary> <ul> </ul> </details> </details> <br /> <details> <summary>All Weekday-Constants</summary> <details> <summary><code>monday</code></summary> <ul> </ul> </details><details> <summary><code>tuesday</code></summary> <ul> </ul> </details><details> <summary><code>wednesday</code></summary> <ul> </ul> </details><details> <summary><code>thursday</code></summary> <ul> </ul> </details><details> <summary><code>friday</code></summary> <ul> </ul> </details><details> <summary><code>saturday</code></summary> <ul> </ul> </details><details> <summary><code>sunday</code></summary> <ul> </ul> </details> </details> <br /> <details> <summary>All Month-Constants</summary> <details> <summary><code>january</code></summary> <ul> <li>jan</li> </ul> </details><details> <summary><code>february</code></summary> <ul> <li>feb</li> </ul> </details><details> <summary><code>march</code></summary> <ul> <li>mar</li> </ul> </details><details> <summary><code>april</code></summary> <ul> <li>apr</li> </ul> </details><details> <summary><code>may</code></summary> <ul> </ul> </details><details> <summary><code>june</code></summary> <ul> <li>jun</li> </ul> </details><details> <summary><code>july</code></summary> <ul> <li>jul</li> </ul> </details><details> <summary><code>august</code></summary> <ul> <li>aug</li> </ul> </details><details> <summary><code>september</code></summary> <ul> <li>sep</li> </ul> </details><details> <summary><code>october</code></summary> <ul> <li>oct</li> </ul> </details><details> <summary><code>november</code></summary> <ul> <li>nov</li> </ul> </details><details> <summary><code>december</code></summary> <ul> <li>dec</li> </ul> </details> </details> <br /> <details> <summary>All Datetime-Constants</summary> <details> <summary><code>days</code></summary> <ul> <li>day</li> </ul> </details><details> <summary><code>weeks</code></summary> <ul> <li>week</li> </ul> </details><details> <summary><code>months</code></summary> <ul> <li>month</li> </ul> </details><details> <summary><code>years</code></summary> <ul> <li>year</li> </ul> </details><details> <summary><code>decades</code></summary> <ul> <li>decade</li> </ul> </details><details> <summary><code>centuries</code></summary> <ul> <li>century</li> </ul> </details><details> <summary><code>millenniums</code></summary> <ul> <li>millennium</li> </ul> </details><details> <summary><code>megaannuums</code></summary> <ul> <li>megaannuum</li> </ul> </details><details> <summary><code>gigaannuums</code></summary> <ul> <li>gigaannuum</li> </ul> </details><details> <summary><code>seconds</code></summary> <ul> <li>second</li> <li>sec</li> <li>secs</li> </ul> </details><details> <summary><code>minutes</code></summary> <ul> <li>minute</li> <li>min</li> <li>mins</li> </ul> </details><details> <summary><code>quarters</code></summary> <ul> <li>quarter</li> <li>qtr</li> <li>qtrs</li> </ul> </details><details> <summary><code>hours</code></summary> <ul> <li>hour</li> </ul> </details> </details> <br /> <details> <summary>All Number-Constants</summary> <details> <summary><code>thirty one</code></summary> <ul> <li>thirtyone</li> <li>thirty-one</li> </ul> </details><details> <summary><code>thirty</code></summary> <ul> </ul> </details><details> <summary><code>twenty nine</code></summary> <ul> <li>twentynine</li> <li>tw