n2words 1.14.0 → 1.16.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 Wael TELLAT
+Copyright (c) 2018-2023 Wael TELLAT
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,12 +4,11 @@
 [![Coverage Status](https://coveralls.io/repos/github/forzagreen/n2words/badge.svg?branch=master)](https://coveralls.io/github/forzagreen/n2words?branch=master)
 [![npm](https://img.shields.io/npm/v/n2words.svg)](https://npmjs.com/package/n2words)
 [![npm](https://img.shields.io/npm/dw/n2words)](https://npmjs.com/package/n2words)
+[![](https://data.jsdelivr.com/v1/package/npm/n2words/badge)](https://www.jsdelivr.com/package/npm/n2words)
 
-n2words is a library that converts a numerical number into a written number.
+__n2words__ converts a numerical number into a written one, supports [27 languages](https://github.com/forzagreen/n2words#supported-languages), and has zero dependencies.
 
-We have support for multiple languages (27 and growing) and our package is lightweight, modular and has no dependencies.
-
-## How To
+## Example
 
 ```js
 n2words(123)   // 'one hundred and twenty-three'
@@ -20,6 +19,8 @@ n2words(123, {lang: 'es'})  // 'ciento veintitrés'
 n2words(123, {lang: 'ar'})  // 'مائة و ثلاثة و عشرون'
 ```
 
+See the [Wiki](https://github.com/forzagreen/n2words/wiki) for examples and advanced usage.
+
 ## Install
 
 ```sh
@@ -34,42 +35,28 @@ n2words is also available on [jsDelivr](https://jsdelivr.com/package/npm/n2words
 
 ```js
 import n2words from 'n2words'
-
-// Source file
-import n2words from 'n2words/lib/n2words.mjs'
-
-// Individual languages (recommended)
-import n2wordsEN from 'n2words/lib/i18n/EN.mjs'
 ```
 
 ### CommonJS
 
 ```js
-var n2words = require('n2words')
-
-// Dynamic Import (source files)
-import('n2words/lib/n2words.mjs').then(n2words => {
+// Dynamic Import
+import('n2words').then(n2words => {
     // Available via "default" method
     n2words.default(100)
 })
-
-// Individual languages
-import('n2words/lib/i18n/EN.mjs').then(n2wordsEN => {
-    n2wordsEN.default(100)
-})
 ```
 
 ### Browser
 
 ```html
 <script src="n2words.js"></script>
+<script>
+    n2words(100)
+</script>
 ```
 
-## Features
-
-- Cardinal numbers
-- Decimal numbers
-- Negative numbers
+You can also [import only specific languages](https://github.com/forzagreen/n2words/wiki/Importing-only-specific-languages) if you don't need all of them.
 
 ## Supported Languages
 
@@ -103,10 +90,7 @@ import('n2words/lib/i18n/EN.mjs').then(n2wordsEN => {
 
 ## Contributing
 
-You can help by adding new languages or by improving existing ones. Also, reporting issues, verifying the correctness of unit tests or adding more test cases is extremely helpful.
-
-All help is welcome!
-
+__This library is in active development.__ We are looking to improve the design and process for language contributors as well as add more languages.
 ## License
 
-MIT
+[MIT](https://github.com/forzagreen/n2words/blob/master/LICENSE)

package/lib/classes/{AbstractLanguage.mjs → AbstractLanguage.js}

@@ -11,10 +11,10 @@ export default class {
 
   /**
    * @param {object} options Options for class.
-   * @param {string} [options.negativeWord = ''] Word that precedes a negative number (if any).
+   * @param {string} [options.negativeWord] Word that precedes a negative number (if any).
    * @param {string} options.separatorWord Word that separates cardinal numbers (i.e. "and").
    * @param {string} options.zero Word for 0 (i.e. "zero").
-   * @param {string} [options.spaceSeparator = ' '] Character that separates words.
+   * @param {string} [options.spaceSeparator] Character that separates words.
    */
   constructor(options) {
     // Merge supplied options with defaults

package/lib/classes/{BaseLanguage.mjs → BaseLanguage.js}

@@ -1,4 +1,4 @@
-import AbstractLanguage from './AbstractLanguage.mjs';
+import AbstractLanguage from './AbstractLanguage.js';
 
 /**
  * Creates new common language class that uses a highest matching word value algorithm.
@@ -11,10 +11,10 @@ export default class extends AbstractLanguage {
 
   /**
    * @param {object} options Options for class.
-   * @param {string} [options.negativeWord = ''] Word that precedes a negative number (if any).
+   * @param {string} [options.negativeWord] Word that precedes a negative number (if any).
    * @param {string} options.separatorWord Word that separates cardinal numbers (i.e. "and").
    * @param {string} options.zero Word for 0 (i.e. "zero").
-   * @param {string} [options.spaceSeparator = ' '] Character that separates words.
+   * @param {string} [options.spaceSeparator] Character that separates words.
    * @param {Array} cards Array of number matching "cards" from highest-to-lowest.
    */
   constructor(options, cards) {

package/lib/i18n/{AR.mjs → AR.js}

@@ -1,39 +1,52 @@
-import AbstractLanguage from '../classes/AbstractLanguage.mjs';
+import AbstractLanguage from '../classes/AbstractLanguage.js';
 
 export class Arabic extends AbstractLanguage {
-  constructor() {
-    super({
+  integerValue = 0;
+
+  decimalValue = 0;
+
+  number = 0;
+
+  arabicOnes = [
+    '', 'واحد', 'اثنان', 'ثلاثة', 'أربعة', 'خمسة', 'ستة', 'سبعة', 'ثمانية',
+    'تسعة',
+    'عشرة', 'أحد عشر', 'اثنا عشر', 'ثلاثة عشر', 'أربعة عشر', 'خمسة عشر',
+    'ستة عشر', 'سبعة عشر', 'ثمانية عشر',
+    'تسعة عشر',
+  ];
+
+  arabicFeminineOnes = [
+    '', 'إحدى', 'اثنتان', 'ثلاث', 'أربع', 'خمس', 'ست', 'سبع', 'ثمان',
+    'تسع',
+    'عشر', 'إحدى عشرة', 'اثنتا عشرة', 'ثلاث عشرة', 'أربع عشرة',
+    'خمس عشرة', 'ست عشرة', 'سبع عشرة', 'ثماني عشرة',
+    'تسع عشرة',
+  ];
+
+  arabicTens = ['عشرون', 'ثلاثون', 'أربعون', 'خمسون', 'ستون', 'سبعون', 'ثمانون', 'تسعون'];
+
+  arabicHundreds = ['', 'مائة', 'مئتان', 'ثلاثمائة', 'أربعمائة', 'خمسمائة', 'ستمائة', 'سبعمائة', 'ثمانمائة', 'تسعمائة'];
+
+  arabicAppendedTwos = ['مئتا', 'ألفا', 'مليونا', 'مليارا', 'تريليونا', 'كوادريليونا', 'كوينتليونا', 'سكستيليونا'];
+
+  arabicTwos = ['مئتان', 'ألفان', 'مليونان', 'ملياران', 'تريليونان', 'كوادريليونان', 'كوينتليونان', 'سكستيليونان'];
+
+  arabicGroup = ['مائة', 'ألف', 'مليون', 'مليار', 'تريليون', 'كوادريليون', 'كوينتليون', 'سكستيليون'];
+
+  arabicAppendedGroup = ['', 'ألفاً', 'مليوناً', 'ملياراً', 'تريليوناً', 'كوادريليوناً', 'كوينتليوناً', 'سكستيليوناً'];
+
+  arabicPluralGroups = ['', 'آلاف', 'ملايين', 'مليارات', 'تريليونات', 'كوادريليونات', 'كوينتليونات', 'سكستيليونات'];
+
+  // isCurrencyPartNameFeminine = true
+
+  // isCurrencyNameFeminine = false
+
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'ناقص',
       separatorWord: 'فاصلة',
       zero: 'صفر'
-    });
-
-    this.integerValue = 0;
-    this.decimalValue = 0;
-    this.number = 0;
-    // this.isCurrencyPartNameFeminine = true
-    // this.isCurrencyNameFeminine = false
-    this.arabicOnes = [
-      '', 'واحد', 'اثنان', 'ثلاثة', 'أربعة', 'خمسة', 'ستة', 'سبعة', 'ثمانية',
-      'تسعة',
-      'عشرة', 'أحد عشر', 'اثنا عشر', 'ثلاثة عشر', 'أربعة عشر', 'خمسة عشر',
-      'ستة عشر', 'سبعة عشر', 'ثمانية عشر',
-      'تسعة عشر',
-    ];
-    this.arabicFeminineOnes = [
-      '', 'إحدى', 'اثنتان', 'ثلاث', 'أربع', 'خمس', 'ست', 'سبع', 'ثمان',
-      'تسع',
-      'عشر', 'إحدى عشرة', 'اثنتا عشرة', 'ثلاث عشرة', 'أربع عشرة',
-      'خمس عشرة', 'ست عشرة', 'سبع عشرة', 'ثماني عشرة',
-      'تسع عشرة',
-    ];
-    this.arabicTens = ['عشرون', 'ثلاثون', 'أربعون', 'خمسون', 'ستون', 'سبعون', 'ثمانون', 'تسعون'];
-    this.arabicHundreds = ['', 'مائة', 'مئتان', 'ثلاثمائة', 'أربعمائة', 'خمسمائة', 'ستمائة', 'سبعمائة', 'ثمانمائة', 'تسعمائة'];
-    this.arabicAppendedTwos = ['مئتا', 'ألفا', 'مليونا', 'مليارا', 'تريليونا', 'كوادريليونا', 'كوينتليونا', 'سكستيليونا'];
-    this.arabicTwos = ['مئتان', 'ألفان', 'مليونان', 'ملياران', 'تريليونان', 'كوادريليونان', 'كوينتليونان', 'سكستيليونان'];
-    this.arabicGroup = ['مائة', 'ألف', 'مليون', 'مليار', 'تريليون', 'كوادريليون', 'كوينتليون', 'سكستيليون'];
-    this.arabicAppendedGroup = ['', 'ألفاً', 'مليوناً', 'ملياراً', 'تريليوناً', 'كوادريليوناً', 'كوينتليوناً', 'سكستيليوناً'];
-    this.arabicPluralGroups = ['', 'آلاف', 'ملايين', 'مليارات', 'تريليونات', 'كوادريليونات', 'كوينتليونات', 'سكستيليونات'];
+    }, options));
   }
 
   digitFeminineStatus(digit/* , groupLevel */) {
@@ -140,9 +153,10 @@ export class Arabic extends AbstractLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new Arabic().floatToCardinal(value);
+export default function(value, options) {
+  return new Arabic(options).floatToCardinal(value);
 }

package/lib/i18n/{AZ.mjs → AZ.js}

@@ -1,12 +1,12 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsAZ extends BaseLanguage {
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'mənfi',
       separatorWord: 'nöqtə',
       zero: 'sıfır'
-    },[
+    }, options), [
       [1000000000000000000n, 'kentilyon'],
       [1000000000000000n, 'katrilyon'],
       [1000000000000n, 'trilyon'],
@@ -54,9 +54,10 @@ export class N2WordsAZ extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsAZ().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsAZ(options).floatToCardinal(value);
 }

package/lib/i18n/{CZ.mjs → CZ.js}

@@ -1,4 +1,4 @@
-import {N2WordsRU} from './RU.mjs';
+import {N2WordsRU} from './RU.js';
 
 export class N2WordsCZ extends N2WordsRU {
   ones = {
@@ -62,11 +62,11 @@ export class N2WordsCZ extends N2WordsRU {
     10: ['quintillion', 'quintilliony', 'quintillionů'], // 10^ 30
   };
 
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'mínus',
       zero: 'nula'
-    });
+    }, options));
   }
 
   get separatorWord() {
@@ -125,9 +125,10 @@ export class N2WordsCZ extends N2WordsRU {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsCZ().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsCZ(options).floatToCardinal(value);
 }

package/lib/i18n/{DE.mjs → DE.js}

@@ -1,12 +1,12 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsDE extends BaseLanguage {
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'minus',
       separatorWord: 'komma',
       zero: 'null'
-    },[
+    }, options), [
       [1000000000000000000000000000n, 'Quadrilliarde'],
       [1000000000000000000000000n, 'Quadrillion'],
       [1000000000000000000000n, 'Trilliarde'],
@@ -96,9 +96,10 @@ export class N2WordsDE extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsDE().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsDE(options).floatToCardinal(value);
 }

package/lib/i18n/{DK.mjs → DK.js}

@@ -1,14 +1,17 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsDK extends BaseLanguage {
-  ordFlag = false;
+  ordFlag;
 
-  constructor() {
-    super({
+  constructor(options) {
+    options = Object.assign({
       negativeWord: 'minus',
       separatorWord: 'komma',
       zero: 'nul',
-    },[
+      ordFlag: false
+    }, options);
+
+    super(options, [
       [1000000000000000000000000000n, 'quadrillarder'],
       [1000000000000000000000000n, 'quadrillioner'],
       [1000000000000000000000n, 'trillarder'],
@@ -48,6 +51,8 @@ export class N2WordsDK extends BaseLanguage {
       [1n, 'et'],
       [0n, 'nul']
     ]);
+
+    this.ordFlag = options.ordFlag;
   }
 
   merge(curr, next) {
@@ -96,9 +101,10 @@ export class N2WordsDK extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsDK().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsDK(options).floatToCardinal(value);
 }

package/lib/i18n/{EN.mjs → EN.js}

@@ -1,15 +1,15 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 /**
  * This class is for converting numbers to english words.
  */
 class English extends BaseLanguage {
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'minus',
       separatorWord: 'point',
       zero: 'zero'
-    },[
+    }, options), [
       [1000000000000000000000000000n, 'octillion'],
       [1000000000000000000000000n, 'septillion'],
       [1000000000000000000000n, 'sextillion'],
@@ -75,9 +75,10 @@ class English extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new English().floatToCardinal(value);
+export default function(value, options) {
+  return new English(options).floatToCardinal(value);
 }

package/lib/i18n/{ES.mjs → ES.js}

@@ -1,14 +1,17 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsES extends BaseLanguage {
-  genderStem = 'o';
+  genderStem;
 
-  constructor() {
-    super({
+  constructor(options) {
+    options = Object.assign({
       negativeWord: 'menos',
       separatorWord: 'punto',
-      zero: 'cero'
-    },[
+      zero: 'cero',
+      genderStem: 'o'
+    }, options);
+
+    super(options, [
       [1000000000000000000000000n, 'cuatrillón'],
       [1000000000000000000n, 'trillón'],
       [1000000000000n, 'billón'],
@@ -53,6 +56,8 @@ export class N2WordsES extends BaseLanguage {
       [1n, 'uno'],
       [0n, 'cero']
     ]);
+
+    this.genderStem = options.genderStem;
   }
 
   merge(curr, next) {
@@ -96,9 +101,10 @@ export class N2WordsES extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsES().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsES(options).floatToCardinal(value);
 }

package/lib/i18n/{FA.mjs → FA.js}

@@ -1,4 +1,4 @@
-import AbstractLanguage from '../classes/AbstractLanguage.mjs';
+import AbstractLanguage from '../classes/AbstractLanguage.js';
 
 export class N2WordsFA extends AbstractLanguage {
   namedNumbers = {
@@ -43,12 +43,12 @@ export class N2WordsFA extends AbstractLanguage {
     1000000: 'میلیون',
   };
 
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'منفى',
       separatorWord: 'ممیّز',
       zero: 'صفر'
-    });
+    }, options));
   }
 
   toCardinal(number) {
@@ -95,9 +95,10 @@ export class N2WordsFA extends AbstractLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsFA().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsFA(options).floatToCardinal(value);
 }

package/lib/i18n/{FR.mjs → FR.js}

@@ -1,12 +1,12 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsFR extends BaseLanguage {
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'moins',
       separatorWord: 'virgule',
       zero: 'zéro'
-    },[
+    }, options), [
       [1000000000000000000000000000n, 'quadrilliard'],
       [1000000000000000000000000n, 'quadrillion'],
       [1000000000000000000000n, 'trilliard'],
@@ -83,9 +83,10 @@ export class N2WordsFR extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsFR().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsFR(options).floatToCardinal(value);
 }

package/lib/i18n/{HE.mjs → HE.js}

@@ -1,7 +1,7 @@
-import {N2WordsRU} from './RU.mjs';
+import {N2WordsRU} from './RU.js';
 
 export class N2WordsHE extends N2WordsRU {
-  and = 'ו';
+  and;
 
   ones = {
     1: 'אחת',
@@ -57,16 +57,21 @@ export class N2WordsHE extends N2WordsRU {
     9: 'תשעת אלפים'
   };
 
-  constructor() {
+  constructor(options) {
     /**
      * @todo Confirm `negativeWord`
      * @todo Set `separatorWord`
      */
-    super({
+    options = Object.assign({
       negativeWord: 'מינוס',
       //separatorWord: ,
-      zero: 'אפס'
-    });
+      zero: 'אפס',
+      and: 'ו'
+    }, options);
+
+    super(options);
+
+    this.and = options.and;
   }
 
   toCardinal(number) {
@@ -116,9 +121,10 @@ export class N2WordsHE extends N2WordsRU {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsHE().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsHE(options).floatToCardinal(value);
 }

package/lib/i18n/{HR.mjs → HR.js}

@@ -1,4 +1,4 @@
-import {N2WordsRU} from './RU.mjs';
+import {N2WordsRU} from './RU.js';
 
 export class N2WordsHR extends N2WordsRU {
   ones = {
@@ -63,14 +63,12 @@ export class N2WordsHR extends N2WordsRU {
     10: ['kvintilijun', 'kvintilijuna', 'kvintilijuna', false], // 10 ^ 30
   };
 
-  feminine = false;
-
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'minus',
       separatorWord: 'zarez',
       zero: 'nula'
-    });
+    }, options));
   }
 
   pluralize(n, forms) {
@@ -121,9 +119,10 @@ export class N2WordsHR extends N2WordsRU {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsHR().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsHR(options).floatToCardinal(value);
 }

package/lib/i18n/{HU.mjs → HU.js}

@@ -1,12 +1,12 @@
-import BaseLanguage from '../classes/BaseLanguage.mjs';
+import BaseLanguage from '../classes/BaseLanguage.js';
 
 export class N2WordsHU extends BaseLanguage {
-  constructor() {
-    super({
+  constructor(options) {
+    super(Object.assign({
       negativeWord: 'mínusz',
       separatorWord: 'egész',
       zero: 'nulla'
-    },[
+    }, options), [
       [1000000000000000000000000000n, 'quadrilliárd'],
       [1000000000000000000000000n, 'quadrillió'],
       [1000000000000000000000n, 'trilliárd'],
@@ -124,9 +124,10 @@ export class N2WordsHU extends BaseLanguage {
 /**
  * Converts a value to cardinal (written) form.
  * @param {number|string} value Number to be convert.
+ * @param {object} options Options for class.
  * @throws {Error} Value cannot be invalid.
  * @returns {string} Value in cardinal (written) format.
  */
-export default function(value) {
-  return new N2WordsHU().floatToCardinal(value);
+export default function(value, options) {
+  return new N2WordsHU(options).floatToCardinal(value);
 }