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.

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

Use pip to install the library:

$ pip install python-datetimeparser

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!

• xmas

• new years eve

• easter

• nicholas day

• april fool day

• saint patricks day
• st. patrick's day
• saint pt. day
• st patrick's day
• st patricks day

• valentine
• valentine day

• end of summer
• end of the summer

• end of winter
• end of the winter

• end of spring
• end of the spring

• end of fall
• end of the fall
• autumn end
• end of autumn
• end of the autumn

• summer
• begin of summer
• begin of the summer

• winter
• begin of winter
• begin of the winter

• spring
• begin of spring
• begin of the spring

• fall
• begin of fall
• begin of the fall
• autumn begin
• autumn
• begin of autumn
• begin of the autumn

• at morning

• at evening

• lunch

• aoc
• begin of aoc
• begin of the aoc
• advent of code begin
• advent of code
• begin of advent of code
• begin of the advent of code

• end of aoc
• end of the aoc
• advent of code end
• end of advent of code
• end of the advent of code

• the end of year
• the end of the year
• end of the year

• the begin of year
• the begin of the year
• begin of the year

• inf

• at the moment
• current time
• current time now

• daylight saving
• daylight saving time

• lunchtime

• dinnertime

• jan

• feb

• mar

• apr

• jun

• jul

• aug

• sep

• oct

• nov

• dec

• day

• week

• month

• year

• decade

• century

• millennium

• megaannuum

• gigaannuum

• second
• sec
• secs

• minute
• min
• mins

• quarter
• qtr
• qtrs

• hour

• thirtyone
• thirty-one

• twentynine
• twenty-nine

• twentyeight
• twenty-eight

• twentyseven
• twenty-seven

• twentysix
• twenty-six

• twentyfive
• twenty-five

• twentyfour
• twenty-four

• twentythree
• twenty-three

• twentytwo
• twenty-two

• twentyone
• twenty-one

• 31st
• 31.
• thirthyfirst
• thirty-first

• 30th
• 30.

• 29th
• 29.
• twentyninth
• twenty-ninth

• 28th
• 28.
• twentyeighth
• twenty-eighth

• 27th
• 27.
• twentyseventh
• twenty-seventh

• 26th
• 26.
• twentysixth
• twenty-sixth

• 25th
• 25.
• twentyfifth
• twenty-fifth

• 24th
• 24.
• twentyfourth
• twenty-fourth

• 23rd
• 23.
• twentythird
• twenty-third

• 22nd
• 22.
• twentysecond
• twenty-second

• 21st
• 21.
• twentyfirst
• twenty-first

• 20th
• 20.

• 19th
• 19.

• 18th
• 18.

• 17th
• 17.

• 16th
• 16.

• 15th
• 15.

• 14th
• 14.

• 13th
• 13.

• 12th
• 12.

• 11th
• 11.

• 10th
• 10.

• 9th
• 9.

• 8th
• 8.

• 7th
• 7.

• 6th
• 6.

• 5th
• 5.

• 4th
• 4.

• 3rd
• 3.

• 2nd
• 2.

• 1st
• 1.