Skip to content

aridevelopment-de/datetimeparser

Repository files navigation


datetimeparser

A python parser library made for parsing english language into datetime objects
made with ❤️ by aridevelopment.de

Report an issue · Request a new feature

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

All Normal-Constants
christmas
  • xmas
holy eve
silvester
  • new years eve
eastern
  • easter
nicholas
  • nicholas day
halloween
april fools day
  • april fool day
thanksgiving
saint patrick's day
  • saint patricks day
  • st. patrick's day
  • saint pt. day
  • st patrick's day
  • st patricks day
valentines day
  • valentine
  • valentine day
summer end
  • end of summer
  • end of the summer
winter end
  • end of winter
  • end of the winter
spring end
  • end of spring
  • end of the spring
fall end
  • end of fall
  • end of the fall
  • autumn end
  • end of autumn
  • end of the autumn
summer begin
  • summer
  • begin of summer
  • begin of the summer
winter begin
  • winter
  • begin of winter
  • begin of the winter
spring begin
  • spring
  • begin of spring
  • begin of the spring
fall begin
  • fall
  • begin of fall
  • begin of the fall
  • autumn begin
  • autumn
  • begin of autumn
  • begin of the autumn
morning
  • at morning
evening
  • at evening
lunchtime
  • lunch
aoc begin
  • 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
aoc end
  • end of aoc
  • end of the aoc
  • advent of code end
  • end of advent of code
  • end of the advent of code
end of year
  • the end of year
  • the end of the year
  • end of the year
begin of year
  • the begin of year
  • the begin of the year
  • begin of the year
infinity
  • inf
today
tomorrow
yesterday
now
  • at the moment
  • current time
  • current time now

All Day-Constants
morning
afternoon
evening
night
morning night
daylight change
  • daylight saving
  • daylight saving time
midnight
midday
dawn
dusk
sunrise
sunset
lunch
  • lunchtime
dinner
  • dinnertime
breakfast

All Weekday-Constants
monday
tuesday
wednesday
thursday
friday
saturday
sunday

All Month-Constants
january
  • jan
february
  • feb
march
  • mar
april
  • apr
may
june
  • jun
july
  • jul
august
  • aug
september
  • sep
october
  • oct
november
  • nov
december
  • dec

All Datetime-Constants
days
  • day
weeks
  • week
months
  • month
years
  • year
decades
  • decade
centuries
  • century
millenniums
  • millennium
megaannuums
  • megaannuum
gigaannuums
  • gigaannuum
seconds
  • second
  • sec
  • secs
minutes
  • minute
  • min
  • mins
quarters
  • quarter
  • qtr
  • qtrs
hours
  • hour

All Number-Constants
thirty one
  • thirtyone
  • thirty-one
thirty
twenty nine
  • twentynine
  • twenty-nine
twenty eight
  • twentyeight
  • twenty-eight
twenty seven
  • twentyseven
  • twenty-seven
twenty six
  • twentysix
  • twenty-six
twenty five
  • twentyfive
  • twenty-five
twenty four
  • twentyfour
  • twenty-four
twenty three
  • twentythree
  • twenty-three
twenty two
  • twentytwo
  • twenty-two
twenty one
  • twentyone
  • twenty-one
twenty
nineteen
eighteen
seventeen
sixteen
fifteen
fourteen
thirteen
twelve
eleven
ten
nine
eight
seven
six
five
four
three
two
one

All NumberCount-Constants
thirty first
  • 31st
  • 31.
  • thirthyfirst
  • thirty-first
thirtieth
  • 30th
  • 30.
twenty ninth
  • 29th
  • 29.
  • twentyninth
  • twenty-ninth
twenty eighth
  • 28th
  • 28.
  • twentyeighth
  • twenty-eighth
twenty seventh
  • 27th
  • 27.
  • twentyseventh
  • twenty-seventh
twenty sixth
  • 26th
  • 26.
  • twentysixth
  • twenty-sixth
twenty fifth
  • 25th
  • 25.
  • twentyfifth
  • twenty-fifth
twenty fourth
  • 24th
  • 24.
  • twentyfourth
  • twenty-fourth
twenty third
  • 23rd
  • 23.
  • twentythird
  • twenty-third
twenty second
  • 22nd
  • 22.
  • twentysecond
  • twenty-second
twenty first
  • 21st
  • 21.
  • twentyfirst
  • twenty-first
twentieth
  • 20th
  • 20.
nineteenth
  • 19th
  • 19.
eighteenth
  • 18th
  • 18.
seventeenth
  • 17th
  • 17.
sixteenth
  • 16th
  • 16.
fifteenth
  • 15th
  • 15.
fourteenth
  • 14th
  • 14.
thirteenth
  • 13th
  • 13.
twelfth
  • 12th
  • 12.
eleventh
  • 11th
  • 11.
tenth
  • 10th
  • 10.
ninth
  • 9th
  • 9.
eighth
  • 8th
  • 8.
seventh
  • 7th
  • 7.
sixth
  • 6th
  • 6.
fifth
  • 5th
  • 5.
fourth
  • 4th
  • 4.
third
  • 3rd
  • 3.
second
  • 2nd
  • 2.
first
  • 1st
  • 1.