Humanized Interval

Human readable interval parser and human-readable generator for Node.js/the Browser.

Merged and wrapped rschmukler/human-interval and EvanHahn/HumanizeDuration.js into a single utility.

Heavily inspired by matthewmueller/date.

Example Usage

1var humanizedInterval = require('humanized-interval');
2
3setTimeout(function() {
4  // Do something crazy!
5}, humanizedInterval('three minutes'));
6

More sophisticated examples

humanizedInterval understands all of the following examples:

1humanizedInterval('one minute'); // 60000
2humanizedInterval('1.5 minutes'); // 90000
3humanizedInterval('3 days and 4 hours'); // 273600000
4humanizedInterval('3 days, 4 hours and 36 seconds'); // 273636000
5
6humanizedInterval(50000); // "5 seconds"
7humanizedInterval(90000); // "1.5 minutes"
8

The full list

Supported Units

Humanized Interval supports the following units

• seconds
• minutes
• hours
• days
• weeks
• months -- assumes 30 days
• years -- assumes 365 days

Wordy Numbers

Humanized Interval supports numbers up to ten being written out in English. If you want to extend it, you can do so by adding more keys to the language map. Alternatively you could add support for alternative languages.

1var humanizedInterval = require('humanized-interval');
2humanizedInterval.languageMap['one-hundred'] = 100
3
4// Adds support for the following:
5humanizedInterval('one-hundred and fifty seconds') // returns 150000