intl-io

intl-io

Culture specific date/time and number formatting and parsing based on ECMAScript Internationalization API (Intl).

Used for localized calendars, date fields and number fields in CxJS.

This module is available in three formats:

• ES Module: dist/index.m.js
• CommonJS: dist/index.cjs.js
• UMD: dist/index.umd.js

Install

$ npm install intl-io --save

Usage

import { DateTimeCulture, NumberCulture } from 'intl-io';

let dateCulture = new DateTimeCulture('es');
dateCulture.format(new Date(), 'yyyyMMdd'); //28/08/2019
dateCulture.format(new Date(), 'yyyyMMMdd'); //28 ago. 2019
dateCulture.format(new Date(), 'yyyyMMdd'); //28 de agosto de 2019
dateCulture.format(new Date(), 'yyyyMMddDDD'); //mié., 28 de agosto de 2019
let date = culture.parse('mié., 28 de agosto de 2019'); //Aug 28, 2019

let numberCulture = new NumberCulture('de');
let formatter = numberCulture.getFormatter({
    style: 'currency',
    currency: 'EUR',
});
let currency = formatter.format(5555.5); //5.555,50 €
let number = numberCulture.parse('5.555,5'); //5555.5

For number formatting options look at https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat.

Date time formatting

Some parts support different length. Four digits means full name, three digits is a long form, two digits is medium and one digit is short form.

• YYYY - full year (e.g. 2019)
• YY - short year (e.g. 19)

• MMMM - long month name (e.g. August)
• MMM - short month name (e.g. Aug)
• MM - two digit month (e.g. 08)
• M - numeric month (e.g. 8)

• DDDD - full day name (e.g. Monday)
• DDD - short day name (e.g. Mon)
• DD - short day name (e.g. Mo)
• D - short day name (e.g. M)

Examples

Format	Description	Result
yyyyMMdd	Short date	09/07/2019
yyyyMMMdd	Medium date	Sep 07, 2019
HHmm	Short time	09:35 PM
HHmmN	Short time	21:35
yyyyMMMddHHmm	Full date time	Sep 07, 2019 09:35 PM

Format Specifiers

Specifier	Part
y, Y	year
M	month
D	day name
d	day
h, H	hours
m, i	minutes
s, S	seconds
a, A	hour12 AM/PM
p, P	hour12 AM/PM
n, N	hour24
t, T	timezone
u, U	UTC timezone
z, Z	UTC timezone

For detailed date formatting options look at https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat.

License

MIT © Codaxy