intl-dt

Light date time library based on the ECMA-402 Internationalization API. It allows to use localized date time formats without the need to import a language package.

Installation

npm install --save intl-dt

Usage

const intlDT = require('intl-dt');
 
const date = new Date(2010, 0, 9, 8, 7, 6);
intlDT.format(date, 'dddd, D. MMMM YYYY HH:mm:ss', 'en');
// Saturday, 9. January 2010 08:07:06
intlDT.format(date, 'dddd, D. MMMM YYYY HH:mm:ss', 'de');
// Samstag, 9. Januar 2010 08:07:06
 
intlDT.months('en')[0]
// January
intlDT.months('de')[0]
// Januar
 
intlDT.days('en')[0]
// Monday
intlDT.days('de')[0]
// Montag

API

intlDT.format

Uses a given date and transformes it by a given template into a localized string.

intlDT.format(date, template[, locales])
intlDT([date[, locales]]).format(template[, locales])
intlDT([locales]).format(date, template[, locales])

intlDT.months

Returns a localized array of all months.

intlDT.months([locales, [type]])
intlDT([locales]).months([type])
intlDT([date[, locales]]).months([type])

intlDT.days

Returns a localized array of all days of the week.

intlDT.days([locales, [type]])
intlDT([locales]).days([type])
intlDT([date[, locales]]).days([type])

Parameters

date: Date

A valid JavaScript date object.

locales: String

A valid locales argument.

Locales are always optional. If not provided the system default local is used.

At the moment only strings are supported.

template: String

A template string defining a template a date may be formated into. The following table defines the valid template tags.

Input	Example	Description
YY	16	Last two digits of a year
YYYY or Y	2016	Full digits of a year
M	2, 12	Month as digits
MM	02, 12	Month as digits with leading zero
MMM	Jan	Month as word in short form
MMMM	January	Month as word in long form
Q	4	Number of quarter
D	1, 28	Day of month as digits
DD	01, 28	Day of month as digits with leading zero
ddd	Mon	Day of week as word in short form
dddd	Monday	Day of week as word in long form
H	6, 1	12 hour time
HH	06, 01	12 hour time with leading zero
h	6, 13	24 hour time
hh	06, 13	24 hour time with leading zero
a or A	am, pm	Ante or post meridiem
m	6, 56	Minutes
mm	06, 56	Minutes with leading zero
s	6, 56	Seconds
ss	06, 56	Seconds with leading zero

type: String

Defines the type of the return value. Default value is long.

Valid types are

• long converts to tag MMMM
• short converts to tag MMM

License

Licensed under the MIT License.