dateable
A small library that provides a few very useful methods for displaying dates, including a formatter and a parser.
Install
$ npm install dateable
Use
var dateable = ;var date = 2009 4 23; var str = ;// => 05/23-2012, 22:10
Parse a formatted date and return the original Date object
dateable;// => Sat May 23 2009 00:00:00 GMT+0000 (CEST)
If you want to include text in the formatting, you need to escape it with either ' or ".
var format = '"I went to the moon a" dddd "in" MMMM, YYYY'; ;// => I went to the moon a Saturday in May, 2009
You can also get the relative date, and the difference between dates.
dateable;// => 4 years agodateable;// => in 8 yearsdateable;// => 3 years
API
dateable(date, format)
Return formatted date
.parse(date, format)
Return original date from format
.when(date, [unit])
Returns relative date
.diff(start, end, [unit])
Returns the difference between the two dates
.language(name)
Set language
Formatting
Based on ISO 8601 with some additions. See tests for examples.
Licence
MIT