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.