intl-js-sdk-dev

Singleton I18n Level2 Common Library

Singleton I18n Level2 Common Library are consumed by Angular Clients and Javascript Clients. It provides functions for DateTimeFormat, NumberFormat and PluralRules objects.

Below are details on how to use the common library for Angular clients and Javascript clients.

Prerequisites

• Run the Singleton service by following the instructions in here.
• Ensure the following are installed and compatible with Angular 7:
  • Git
  • Node.js 10

How to build and use the common library

• Clone the repository using Git.

  git clone [e-mail]:vmware/singleton.git intl-js-sdk
  

• Go to the project's root directory.

  cd intl-js-sdk
  

• Checkout the client library branch

  git checkout intl-js-sdk
  

• Download dependencies

  npm install
  

  Note：The above steps are used to reuse the source code. The stepscould be skipped if user only wants to use the common library for Angular or Javascript applications.

• Import the library in your Angular or Javascript application

  cd <root-of-your-app>
  
  open package.json file and add the following entry to dependencies section.
     "intl-js-sdk": "^0.0.1"
  
  Then run the following command:
     npm install 
  
  
  

• Sample code:

  import { I18n } from 'intl-js-sdk'; ...

  // DatetimeFormat I18n.registerLocaleData('en', sourcePatternData.categories);

  const dt_options: I18n.DateTimeFormatOptions = {pattern: 'full'}; const date = new Date(2019, 2, 22, 9, 3, 1, 550); // const formatter = new I18n.DateTimeFormat('en', dt_options); const IntlDate = I18n.DateTimeFormat.getInstance('en',options); const formattedDate = IntlDate.format(date);

  // NumberFormat I18n.registerLocaleData('de', dePatternData.categories);

  const numberFormater = (value: any, type: string, locale: string) => { if (type === 'currencies') { const currencyCode = locale === 'en' ? 'USD' : 'EUR'; const option: I18n.NumberFormatOptions = {numberFormatType: type, currencyCode: currencyCode}; const numberFormat = I18n.NumberFormat.getInstance(locale,option); return numberFormat.format(value); } else if (type === 'plural') { const option: I18n.NumberFormatOptions = {numberFormatType: type, currencyCode: ''}; const numberFormat = I18n.NumberFormat.getInstance(locale,option); return numberFormat.format(value); } else { const option: I18n.NumberFormatOptions = {numberFormatType: type, currencyCode: ''}; const numberFormat = I18n.NumberFormat.getInstance(locale,option); return numberFormat.format(value); } };

  const dec = numberFormater(12345, 'decimal', 'de'); const per = mnumberFormater(0.123, 'percent', 'de') const plu = numberFormater(12345, 'plural', 'de'); const cur = mnumberFormater(0.123, 'currencies', 'de')

  // PluralRules const pluralDE = I18n.PluralRules.getInstance('de'); I18n.registerLocaleData('de', dePatternData.categories); const pluralFormat = pluralDE.select(1)

  // For detailed code examples, please refer the unit test cases under test folder.