dtf

Simple and compact Date formatting. Extracted from core-js. By default available english (en) and russian (ru) locales.

development version, production version

dtf
  .format(date, format, locale?) -> str
  .formatUTC(date, format, locale?) -> str
  .locale(locale?) -> locale
  .addLocale(locale, object) -> dtf
  .extend() -> dtf
Date
  #format(format, locale?) -> str, available after dtf.extend()
  #formatUTC(format, locale?) -> str, available after dtf.extend()

Token	Unit	Sample
s	Seconds	0-59
ss	Seconds, 2 digits	00-59
m	Minutes	0-59
mm	Minutes, 2 digits	00-59
h	Hours	0-23
hh	Hours, 2 digits	00-23
D	Date	1-31
DD	Date, 2 digits	01-31
W	Weekday, string	Вторник
N	Month	1-12
NN	Month, 2 digits	01-12
M	Month, string	Ноябрь
MM	Of month, string	Ноября
Y	Year, full	2014
YY	Year, 2 digits	14

Examples:

var dtf = require('dtf'); // w/o modular system available as global `dtf`

dtf.format(new Date(), 'W, MM D, YY, h:mm:ss');        // => 'Friday, November 28, 14, 18:47:05'
dtf.formatUTC(new Date(), 'W, MM D, YY, h:mm:ss');     // => 'Friday, November 28, 14, 12:47:05'

dtf.format(new Date(), 'W, D MM Y г., h:mm:ss', 'ru'); // => 'Пятница, 28 Ноября 2014 г., 18:07:25'

// set default locale
dtf.locale('ru');
dtf.format(new Date(), 'W, D MM Y г., h:mm:ss');       // => 'Пятница, 28 Ноября 2014 г., 18:07:25'

dtf.format(new Date(), 'DD.NN.YY');         // => '28.11.14'
dtf.format(new Date(), 'hh:mm:ss');         // => '18:47:05'
dtf.format(new Date(), 'DD.NN.Y hh:mm:ss'); // => '28.11.2014 18:47:05'
dtf.format(new Date(), 'W, D MM Y года');   // => 'Пятница, 28 Ноября 2014 года'
dtf.format(new Date(), 'D MM, h:mm');       // => '28 Ноября, 16:47'
dtf.format(new Date(), 'M Y');              // => 'Ноябрь 2014'

dtf.locale('en');

// adds Date#format and Date#formatUTC methods to Date.prototype:
dtf.extend();

new Date().format('W, MM D, YY, h:mm:ss');        // => 'Friday, November 28, 14, 18:47:05'
new Date().formatUTC('W, MM D, YY, h:mm:ss');     // => 'Friday, November 28, 14, 12:47:05'

new Date().format('W, D MM Y г., h:mm:ss', 'ru'); // => 'Пятница, 28 Ноября 2014 г., 18:07:25'

dtf.locale('ru');
new Date().format('W, D MM Y г., h:mm:ss');       // => 'Пятница, 28 Ноября 2014 г., 18:07:25'

new Date().format('DD.NN.YY');         // => '28.11.14'
new Date().format('hh:mm:ss');         // => '18:47:05'
new Date().format('DD.NN.Y hh:mm:ss'); // => '28.11.2014 18:47:05'
new Date().format('W, D MM Y года');   // => 'Пятница, 28 Ноября 2014 года'
new Date().format('D MM, h:mm');       // => '28 Ноября, 16:47'
new Date().format('M Y');              // => 'Ноябрь 2014'

// example adding new locale:
dtf.addLocale('ru', {
  weekdays: 'Воскресенье,Понедельник,Вторник,Среда,Четверг,Пятница,Суббота',
  months: 'Январ:я|ь,Феврал:я|ь,Март:а|,Апрел:я|ь,Ма:я|й,Июн:я|ь,Июл:я|ь,Август:а|,Сентябр:я|ь,Октябр:я|ь,Ноябр:я|ь,Декабр:я|ь'
});

Changelog

1.0.0 - 2015.05.31

• publish