A lightweight JavaScript date library for parsing and formatting natural language relative dates.
An small example set of strings that can be parsed:
two seconds
1 second
every 4 days
every other day
1 hour from now
after 2 hours
once per hour
every 48 hours
Install with npm:
npm install dateparser --save
You can use Bower to install.
bower install dateparser
bower install jhaynie/dateparser
If you don't use Bower as a package manager, you can copy the minified JS from dateparser.min.js to the location of your web assets directory and inclue it in your HTML manually.
The API has only 2 methods parse and format.
To parse a date, call parse with a string of text. The result is an object with two properties: value (Number) and relative (Boolean). The value property is the milliseconds value. The relative property indicates if the value is a relative date or a recurring date.
var result = dateparser.parse('every 1 hour');
console.log('%d', result.value);If the results relative property is true, the value will be a date in milliseconds format from Date.now(). If the reuslts relative property is false, the value will be the absolute milliseconds value of the parsed string (for example, 1 seconds will be returned as 1000).
Format a result object returned from parse in a human readable format.
var result = dateparser.parse('every 1 hour');
console.log(dateparser.format(result));Copyright (c) 2015 by Jeff Haynie. Licensed under the Apache-2.0 license.