Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A simple Ruby natural language parser for elapsed time
Ruby
Branch: master
Pull request Compare This branch is 1 commit ahead, 42 commits behind hpoydar:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
spec
.gitignore
Gemfile
Gemfile.lock
MIT-LICENSE
README.rdoc
Rakefile
VERSION
chronic_duration.gemspec

README.rdoc

Chronic Duration

A simple Ruby natural language parser for elapsed time. (For example, 4 hours and 30 minutes, 6 minutes 4 seconds, 3 days, etc.) Returns all results in seconds. Will return an integer unless you get tricky and need a float. (4 minutes and 13.47 seconds, for example.)

The reverse can also be accomplished with the output method. So pass in seconds and you can get strings like 4 mins 31.51 secs (default format), 4h 3m 30s, or 4:01:29.

Installation

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

Usage

>> require 'chronic_duration'
=> true
>> ChronicDuration.parse('4 minutes and 30 seconds')
=> 270
>> ChronicDuration.output(270)
=> 4 mins 30 secs
>> ChronicDuration.output(270, :format => :short)
=> 4m 30s
>> ChronicDuration.output(270, :format => :long)
=> 4 minutes 30 seconds
>> ChronicDuration.output(270, :format => :chrono)
=> 4:30
>> ChronicDuration.output(1299600, :weeks => true)
=> 2 wks 1 day 1 hr
>> ChronicDuration.output(1299600, :weeks => true, :units => 2)
=> 2 wks 1 day
>> ChronicDuration.output(1296000)
=> 15 days

Nil is returned if the string can't be parsed

Examples of parse-able strings:

  • '12.4 secs'

  • '1:20'

  • '1:20.51'

  • '4:01:01'

  • '3 mins 4 sec'

  • '2 hrs 20 min'

  • '2h20min'

  • '6 mos 1 day'

  • '47 yrs 6 mos and 4d'

  • 'two hours and twenty minutes'

  • '3 weeks and 2 days'

ChronicDuration.raise_exceptions can be set to true to raise exceptions when the string can't be parsed.

>> ChronicDuration.raise_exceptions = true
=> true
>> ChronicDuration.parse('4 elephants and 3 Astroids')
ChronicDuration::DurationParseError: An invalid word "elephants" was used in the string to be parsed.

ChronicDuration.use_units can be used to use only a subset of the supported units. For example:

>> ChronicDuration.use_units :hours, :minutes
>> ChronicDuration.parse('1:00')
=> 3600
>> ChronicDuration.output(3600 * 48)
>> '48 hrs'

To revert to all supported units just pass :all to use_units:

>> ChronicDuration.use_units :all
>> ChronicDuration.output(3600 * 48)
>> '2 days'

Contributors

brianjlandau, jduff, olauzon, roboman, ianlevesque

TODO

  • Benchmark, optimize

  • Context specific matching (E.g., for '4m30s', assume 'm' is minutes not months)

  • Smartly parse vacation-like durations (E.g., '4 days and 3 nights')

  • :chrono output option should probably change to something like 4 days 4:00:12 instead of 4:04:00:12

  • Other locale support

Something went wrong with that request. Please try again.