A JavaScript library for parsing colloquial date/time and date/time range strings

This library began as an experiment in the use of parser combinators as a technique for coping with the variety and ambiguity of natural date/time and date/time range strings found in the wild. The idea was to define a set of elemental parsers for the various elements of date/time phrases - year, month, day, hour, minute, etc.- and then use combinator functions to define parsers representing all of the various ways that these elements might be combined to form a phrase representing a date/time or date/time range.

The following are examples of the types of phrases that the parser can understand.

• Aug 24th 2017

• August 24 2017 at 8 pm
• Tomorrow 8pm

• August 24 2017 8:00 - 10:00 pm

• May 27 5pm - May 30 12pm

• Aug 28th-29th @ 5pm

• May 27 - December 31 from 12:00 PM - 5:00 PM