node package manager
Love JavaScript? Your insights can make it even better. Take the 2017 JavaScript Ecosystem Survey »


Human Interval

Human readable interval parser for Node.js/the Browser.

Heavily inspired by matthewmueller/date.

Example Usage

var humanInterval = require('human-interval');
setTimeout(function() {
  // Do something crazy! 
}, humanInterval('three minutes'));

More sophisticated examples

humanInterval understands all of the following examples:

humanInterval('one minute');
humanInterval('1.5 minutes');
humanInterval('3 days and 4 hours');
humanInterval('3 days, 4 hours and 36 seconds');

The full list

Supported Units

Human Interval supports the following units

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

Wordy Numbers

Human 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.

var humanInterval = require('human-interval');
humanInterval.languageMap['one-hundred'] = 100
// Adds support for the following: 
humanInterval('one-hundred and fifty seconds') // returns 150000