date-plus

Javascript dates extended with dateformat

• Tiny wrapper function to create dates
• returns normal Date objects extended with .format()
• uses the built-in date parser, fixes a parser annoyance in ES5
• unlike dateformat, format() doesn't throw if the date is invalid
• choice of language strings - currently de and en are included

installation

$ npm install date-plus

usage

var date = require('date-plus');

// parse using native javascript parser
var d = date('5/10/2015');

// format
var output = d.format('ddd, dd mmm yyyy HH:MM:ss Z');

// or use a predefined mask
var output = d.format('expiresHeaderFormat');

// shortcut for date(d).format(fmt) - 2nd arg format string
var output = date(d, fmt);

// non-truthy input means current date/time
var now = date('');

var d = date('inva/lid/date');
var isValid = d.valid;          // false
var output = d.format();        // 'No Date'

// set language to german
date.lang('de');

// access dateformat masks
date.dateformat.masks.shortDate = ('yyyy.mm.dd');

format patterns

| pattern | interpretation | | :---------- | :------------------------------ | | d | day | | dd | day with leading 0 | | ddd | day of week abbreviated | | dddd | day of week full | | m | month | | mm | month with leading 0 | | mmm | month abbreviated | | mmmm | month full | | yy | year 2 digit | | yyyy | year 4 digit | | h | hours (12) | | hh | hours (12) with leading 0 | | H | hours (24) | | HH | hours (24) with leading 0 | | M | minutes | | MM | minutes with leading 0 | | s | seconds | | ss | seconds with leading 0 | | l | milliseconds 3 digits | | L | milliseconds 2 digits | | t | a or p for am or pm | | tt | am or pm | | T | A or P for am or pm | | TT | AM or PM | | Z | US timezone or GMT-???? | | o | UTC offset e.g. +1000 or -0230 | | S | day suffix e.g. 'nd' for 2 | | W | week in year | | N | day in week | | UTC:fmt | render UTC instead of local |

format masks

| mask name | interpretation | | :-------------------- | :------------------------------ | | default | ddd mmm dd yyyy HH:MM:ss | | shortDate | m/d/yy | | mediumDate | mmm d, yyyy | | longDate | mmmm d, yyyy | | fullDate | dddd, mmmm d, yyyy | | shortTime | h:MM TT | | mediumTime | h:MM:ss TT | | longTime | h:MM:ss TT Z | | isoDate | yyyy-mm-dd | | isoTime | HH:MM:ss | | isoDateTime | yyyy-mm-dd'T'HH:MM:sso | | isoUtcDateTime | UTC:yyyy-mm-dd'T'HH:MM:ss'Z' | | expiresHeaderFormat | ddd, dd mmm yyyy HH:MM:ss Z |

parsing yyyy-mm-dd

ES5 interprets strings matching yyyy-mm-dd as UTC even when running in other timezones.

E.g. 2015-9-15 is assumed to be midnight on that date in the local timezone

But 2015-10-15 is interpreted as midnight on that date in the UTC timezone because the date uses an ISO format and has a 2-digit month. This is problematic e.g. for code parsing unpadded dates passed via JSON.

This module provides a small polyfill to parse yyyy-mm-dd dates as local even in ES5.

credits

• this package includes dateformat.js from dateformat
• which was based on Steven Levithan's date-time-format
• additional inspiration from PhantomJS-DatePolyfill