Skip to content

Repository files navigation

intl-io versiondownloads

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 four formats:

  • CommonJS: dist/intl-io.js
  • ES Module: dist/intl-io.module.js
  • Modern ES Module: dist/intl-io.modern.js
  • UMD: dist/intl-io.umd.js

Install

$ npm install intl-io --save

Usage

import{DateTimeCulture,NumberCulture}from'intl-io';letdateCulture=newDateTimeCulture('es');dateCulture.format(newDate(),'yyyyMMdd');//28/08/2019dateCulture.format(newDate(),'yyyyMMMdd');//28 ago. 2019dateCulture.format(newDate(),'yyyyMMdd');//28 de agosto de 2019dateCulture.format(newDate(),'yyyyMMddDDD');//mié., 28 de agosto de 2019letdate=culture.parse('mié., 28 de agosto de 2019',{loose: true});//Aug 28, 2019letnumberCulture=newNumberCulture('de');letformatter=numberCulture.getFormatter({style: 'currency',currency: 'EUR',});letcurrency=formatter.format(5555.5);//5.555,50 €letnumber=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

FormatDescriptionResult
yyyyMMddShort date09/07/2019
yyyyMMMddMedium dateSep 07, 2019
HHmmShort time09:35 PM
HHmmNShort time21:35
yyyyMMMddHHmmFull date timeSep 07, 2019 09:35 PM

Format Specifiers

SpecifierPart
y, Yyear
Mmonth
Dday name
dday
h, Hhours
m, iminutes
s, Sseconds
a, Ahour12 AM/PM
p, Phour12 AM/PM
n, Nhour24
t, Ttimezone
u, UUTC timezone
z, ZUTC timezone

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

License

MIT © Codaxy

About

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

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages