A package to load full ICU data in Node.js environment with JavaScript Intl API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Super awesome commit Dec 18, 2016
__tests__ add new test Jan 18, 2018
src Improve comments Jul 29, 2017
.gitignore Update README Dec 30, 2016
.travis.yml Add Travis CI Dec 20, 2016
LICENSE Initial commit Dec 15, 2016
README.md update README Jan 18, 2018
index.js Improve comments Jul 29, 2017
package-lock.json close #2 Jul 30, 2017
package.json update semver according to update dependencies Jan 18, 2018
preinstall.js close #2 Jul 30, 2017

README.md

ICU Loader · Travis npm npm

A package to load full ICU data in Node.js environment with JavaScript Intl API

But Why?

To use JavaScript Intl API, Node.js needs to run with --icu-data-dir option that provides us to have Intl API in our Node environment but because of the structure of the Node.js we're not able to use this option directly as requiring it in our scripts. through child_process module, this feature will be possible.

Example

import { IDate } from 'icu-loader'

let date = new IDate(new Date(2016, 9, 16))
date.toLocaleString('en-US', { year: 'numeric', month: 'long', day: 'numeric' })
  .then(result => console.log(result)) // October 16, 2016

Table of Contents

Requirements

ICU Loader requires the following to run:

Usage

ICU Loader is easiest to use when installing with npm:

npm install icu-loader --save

Then you can load the module into your codes by the ES module or CommonJS:

// ES module
import {IDate, IString, INumber} from 'icu-loader';

// Or import specific class
import IString from 'icu-loader';

// CommonJS
let date = require('icu-loader').IDate;
let string = require('icu-loader').IString;
let number = require('icu-loader').INumber;

According to JavaScript Intl API, the module has the following objects (IDate, IString, INumber) and various methods.

The star (*) sign means the argument is optional.

IDate

Syntax

new IDate()
new IDate(dateObj)
Argument Name Type Description
dateObj Date, String the reference date object

Methods

All arguments of the methods of Date object are same, the following methods:

  • toLocaleString(dateObj, locale, [options])
  • toLocaleDateString(dateObj, locale, [options])
  • toLocaleTimeString(dateObj, locale, [options])

Arguments

Argument Name Type Description
locale String the locale string that date will be displayed in
options * Object documents

Example

import IDate from 'icu-loader'

let date = new IDate(new Date(2016, 9, 16))

// US English uses month-day-year order and 12-hour time with AM/PM
date.toLocaleString('en-US')
  .then(result => console.log(result)); // "9/16/2016, 0:00:00 PM"

// request a weekday along with a long date
var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
date.toLocaleString('de-DE', options)
  .then(result => cosnole.log(result)); // "Sonntag, 16. Oktober 2016"

// Arabic in most Arabic speaking countries uses real Arabic digits
date.toLocaleDateString('ar-EG')
  .then(result => cosnole.log(result)); // "۲۰۱۶/۹/۱۶"

// Korean uses year-month-day order and 12-hour time with AM/PM
date.toLocaleTimeString(new Date(2016, 9, 16, 14, 15, 05), 'ko-KR')
  .then(result => cosnole.log(result)); // "오후 2:15:05"

// sometimes even the US needs 24-hour time
date.toLocaleTimeString(new Date(), 'en-US', { hour12: false }))
  .then(result => cosnole.log(result)); // "19:00:00"

IString

Syntax

new IDate(string)
Argument Name Type Description
string String the reference string object

Methods

The IString class just has one method to comparing two string in same or different locales, the following method:

  • localeCampare(referenceStr, compareString, locale, [options])

Arguments

Argument Name Type Description
compareString String the comparable string
locale String the locale string that string will be compared in
options * Object documents

Example

import IString from 'icu-loader'

// The letter  "a" is before "c" yielding a negative value
new IString('a').localeCompare('c')
  .then(result => cosnole.log(result)); // -2 or -1 (or some other negative valu e)

// Using locales
new IString('ä').localeCompare('z', 'sv')
  .then(result => cosnole.log(result)); // a positive value: in Swedish, ä sorts after z

// in German, ä has a as the base letter
new IString('ä').localeCompare('a', 'de', { sensitivity: 'base' }))
  .then(result => cosnole.log(result)); // 0

Number

Syntax

new INumber(number)
Argument Name Type Description
number Number the reference number object

Methods

this class has one method to represent a number in different locales, the following method:

  • toLocaleString(numberObj, locale, [options])

Arguments

Argument Name Type Description
locale String the locale string that number will be displayed in
options * Object documents

Example

import INumber from 'icu-loader';

// English locale
new INumber(3500).toLocaleString()
  .then(result => cosnole.log(result)); // Displays "3,500" if in U.S.

// German uses comma as decimal separator and period for thousands
new INumber(123456.789).toLocaleString('de-DE')
  .then(result => cosnole.log(result)); // 123.456,789

// Using options
new INumber(30000000000).toLocaleString('fa-IR', { style: 'currency', currency: 'IRR' })
  .then(result => cosnole.log(result)); // ‎ریال۳۰٬۰۰۰٬۰۰۰٬۰۰۰

Contributing

To contribute to ICU Loader, clone this repo locally and commit your code on the development branch. Please run the linter before opening a pull request:

## To run tests
npm run test

## To find out the errors
npm run lint

## To fix automatically the errors
npm run lint:fix

License

ICU Loader is licensed under the MIT license, also full-icu package is part of ICU.

Copyright © 2018, Masoud Ghorbani