Chronic Between¶ ↑

A simple Ruby natural language parser for date and time ranges. (For example, Mon-Fri 09:00-16:30, etc.) Returns a boolean result.

Several date and time ranges can be supplied with matching patterns being separated by a comma.

Installation¶ ↑

$ sudo gem sources -a http://gemcutter.org
$ sudo gem install chronic_between

Usage¶ ↑

>> s = 'Mon-Fri 9:00-16:30, Saturday, Sunday'
>> c = ChronicBetween.new(s)

>> DateTime.now      
=> #<DateTime: 2011-03-26T16:54:40+00:00

>> c.within? DateTime.now
=> true

>> c.within? DateTime.parse("28-Mar-2011 14:33")
=> true

>> c.within? DateTime.parse("28-Mar-2011 08:33")
=> false

Examples of parse-able strings:

• ‘Mon-Fri 9:00-16:30’

• ‘saturday’

• ‘12:00-13:00’

• ‘Sat,Sun’

• ‘Mon-Fri 9:00-16:30, Saturday, Sunday’

• ‘Mon-Fri 9:00-16:30, Saturday, 10:15-10:45’

• ‘Sat 18:15-21:40’

• ‘Mon-Wed’

• ‘Mon-Fri 9:00 to 16:30’

• ‘9:00-16:30 Mon-Fri’

• ‘9:00 to 16:30 Mon-Fri’

• ‘3:45 to 5:15’

• ‘Mon 3:45 to 5:15’

• ‘3:45-5:15 Mon’

• ‘3:45 to 5:15 Mon’

• ‘after 6pm’

• ‘before 9pm’

• ‘April 2nd - April 5th 12:00-14:00’

• ‘April 5th - April 9th’

• ‘April 5th’

• ‘not before 6pm’

• ‘except after 6pm’

• ‘Sunday, after 6pm’

• ‘Saturday, not after 6pm’