Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (currency-in-words) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

currency-in-words

Convert currency or similar number formats to respective words

Installation:

npm i currency-in-words

Usage:

import { convert } from 'currency-in-words'

//  indian-system
const result = convert('777')
//  or
const result = convert('777', { format: 'in' })

//  international-system
const result = convert('777', { format: 'intl' })

console.log('777')  // seven hundred seventy seven
console.log('1022') // one thousand twenty two
console.log('1,022') // NaN
console.log('66.123') // sixty six.twelve

console.log('100000') // one lakh
console.log('100000', { format: 'int' }) // one hundred thousand

Note

Expect NaN when ',' is present, eg: '100,000.99'

Decimals are corrected to two places

Adding test-case results just to make your life easier..

Note

Commas in the test cases are just for readability, but doesn't support in the input.

Convert Indian system
    ✓ returns "NaN" for undefined (1 ms)
    ✓ returns "NaN" for null
    ✓ returns "NaN" for an invalid number(a1.01)
    ✓ returns "NaN" for an invalid number(1.1a)
    ✓ returns "NaN" for an invalid number(random string)
    ✓ returns "one" when given the input 1
    ✓ returns "nine" when given the input 9
    ✓ returns "ten" when given the input 10
    ✓ returns "eleven" when given the input 11
    ✓ returns "nineteen" when given the input 19
    ✓ returns "ninety" when given the input 90
    ✓ returns "ninety nine" when given the input 99
    ✓ returns "one hundred" when given the input 100
    ✓ returns "one hundred nine" when given the input 109 (1 ms)
    ✓ returns "one hundred ten" when given the input 110
    ✓ returns "one hundred eleven" when given the input 111
    ✓ returns "one hundred nineteen" when given the input 119
    ✓ returns "one hundred ninety" when given the input 190 (1 ms)
    ✓ returns "one hundred ninety nine" when given the input 199
    ✓ returns "one thousand" when given the input 1000
    ✓ returns "one thousand one" when given the input 1001
    ✓ returns "one thousand ten" when given the input 1010
    ✓ returns "one thousand one hundred ten" when given the input 1110
    ✓ returns "one thousand one hundred eleven" when given the input 1111
    ✓ returns "one thousand one hundred ninety nine" when given the input 1199
    ✓ returns "one thousand nine hundred" when given the input 1900 (1 ms)
    ✓ returns "one thousand nine hundred ninety nine" when given the input 1999
    ✓ returns "ten thousand" when given the input 10000
    ✓ returns "eleven thousand one hundred nine" when given the input 11109
    ✓ returns "eleven thousand one hundred ten" when given the input 11110
    ✓ returns "eleven thousand one hundred eleven" when given the input 11111
    ✓ returns "eleven thousand one hundred nineteen" when given the input 11119 (2 ms)
    ✓ returns "eleven thousand one hundred ninety" when given the input 11190
    ✓ returns "eleven thousand one hundred ninety nine" when given the input 11199
    ✓ returns "one lakh" when given the input 1,00,000
    ✓ returns "one lakh eleven thousand one hundred nine" when given the input 1,11,109
    ✓ returns "one lakh eleven thousand one hundred ten" when given the input 1,11,110
    ✓ returns "one lakh eleven thousand one hundred eleven" when given the input 1,11,111 (1 ms)
    ✓ returns "one lakh eleven thousand one hundred nineteen" when given the input 1,11,119
    ✓ returns "one lakh leven thousand one hundred ninety" when given the input 1,11,190
    ✓ returns "one lakh eleven thousand one hundred ninety nine" when given the input 1,11,199
    ✓ returns "ten lakh" when given the input 10,00,000
    ✓ returns "ten lakh eleven thousand one hundred nine" when given the input 10,11,109
    ✓ returns "ten lakh eleven thousand one hundred ten" when given the input 10,11,110
    ✓ returns "ten lakh eleven thousand one hundred eleven" when given the input 10,11,111
    ✓ returns "ten lakh eleven thousand one hundred nineteen" when given the input 10,11,119
    ✓ returns "ten lakh leven thousand one hundred ninety" when given the input 10,11,190
    ✓ returns "ten lakh eleven thousand one hundred ninety nine" when given the input 10,11,199
    ✓ returns "one crore" when given the input 1,00,00,000
    ✓ returns "one crore one lakh eleven thousand one hundred nine" when given the input 1,01,11,109
    ✓ returns "one crore one lakh eleven thousand one hundred ten" when given the input 1,01,11,110
    ✓ returns "one crore one lakh eleven thousand one hundred eleven" when given the input 1,01,11,111
    ✓ returns "oone crore ne lakh eleven thousand one hundred nineteen" when given the input 1,11,119
    ✓ returns "one crore one lakh leven thousand one hundred ninety" when given the input 1,11,190
    ✓ returns "one crore one lakh eleven thousand one hundred ninety nine" when given the input 1,11,199
    ✓ returns "ten crore ten lakh" when given the input 10,00,00,000
    ✓ returns "tten crore en lakh eleven thousand one hundred nine" when given the input 10,00,11,109
    ✓ returns "ten crore ten lakh eleven thousand one hundred ten" when given the input 10,00,11,110
    ✓ returns "ten crore ten lakh eleven thousand one hundred eleven" when given the input 10,00,11,111
    ✓ returns "ten crore ten lakh eleven thousand one hundred nineteen" when given the input 10,00,11,119
    ✓ returns "ten crore ten lakh leven thousand one hundred ninety" when given the input 10,00,11,190
    ✓ returns "ten crore ten lakh eleven thousand one hundred ninety nine" when given the input 10,00,11,199
    ✓ returns "five hundred fifty five" when given the input 555
    ✓ returns "seventy seven thousand two hundred eighty nine" when given the input 77,289
    ✓ returns "seventeen crore ninety nine lakh one hundred" when given the input 17,99,00,100 (1 ms)
    ✓ returns "ninety nine crore ninety nine lakh ninety nine thousand nine hundred ninety nine" when given the input 99,99,99,999
    ✓ returns "one.one" when given the input 1.1
    ✓ returns "fifty seven.ninety nine" when given the input 57.99
    ✓ returns "ten" when given the input 10.01; ignore x.01 to x.09
    ✓ returns "zero" when given the input 0.00
    ✓ returns "zero" when given the input 000
    ✓ returns "three hundred thirty" when given the input 00330; corrected leading zeros
    ✓ returns "eighty eight.twenty" when given the input 088.200; corrected leading zeros and two decimal places
    ✓ returns "zero" when given the input 0.00
  Convert international system
    ✓ returns "NaN" for undefined (1 ms)
    ✓ returns "NaN" for null
    ✓ returns "NaN" for an invalid number(a1.01)
    ✓ returns "NaN" for an invalid number(1.1a)
    ✓ returns "NaN" for an invalid number(random string)
    ✓ returns "one" when given the input 1
    ✓ returns "nine" when given the input 9
    ✓ returns "ten" when given the input 10
    ✓ returns "eleven" when given the input 11
    ✓ returns "nineteen" when given the input 19 (1 ms)
    ✓ returns "ninety" when given the input 90
    ✓ returns "ninety nine" when given the input 99
    ✓ returns "one hundred" when given the input 100
    ✓ returns "one hundred nine" when given the input 109
    ✓ returns "one hundred ten" when given the input 110
    ✓ returns "one hundred eleven" when given the input 111
    ✓ returns "one hundred nineteen" when given the input 119
    ✓ returns "one hundred ninety" when given the input 190
    ✓ returns "one hundred ninety nine" when given the input 199 (1 ms)
    ✓ returns "one thousand" when given the input 1,000
    ✓ returns "one thousand one" when given the input 1,001
    ✓ returns "one thousand eleven" when given the input 1,011
    ✓ returns "one thousand one hundred eleven" when given the input 1,111
    ✓ returns "ten thousand" when given the input 10,000
    ✓ returns "ten thousand one" when given the input 10,001
    ✓ returns "ten thousand eleven" when given the input 10,011
    ✓ returns "ten thousand one hundred eleven" when given the input 10,111
    ✓ returns "eleven thousand one hundred eleven" when given the input 11,111
    ✓ returns "one hundred thousand" when given the input 100,000
    ✓ returns "one million" when given the input 1,000,000
    ✓ returns "one million one" when given the input 1,000,001
    ✓ returns "one million eleven" when given the input 1,000,011
    ✓ returns "one million one hundred" when given the input 1,000,100
    ✓ returns "one million one hundred eleven" when given the input 1,000,111
    ✓ returns "one million one thousand" when given the input 1,001,000
    ✓ returns "one million" when given the input 1,001,001
    ✓ returns "one million one thousand eleven" when given the input 1,001,001
    ✓ returns "one million ten thousand one hundred eleven" when given the input 10,010,111
    ✓ returns "one million eleven thousand one hundred eleven" when given the input 1,011,111
    ✓ returns "one million one hundred thousand" when given the input 1,100,000 (1 ms)
    ✓ returns "ten million" when given the input 10,011,111
    ✓ returns "nine hundred ninety nine million nine hundred ninety nine thousand nine hundred ninety nine" when given the input 999,999,999
    ✓ returns "ten million" when given the input 10,000,000.99
    ✓ returns "ten million.fifty seven" when given the input 10,000,000.57
    ✓ returns "zero.ninety nine" when given the input 0.99
    ✓ returns "one.one" when given the input 1.1
    ✓ returns "fifty seven.ninety nine" when given the input 57.99
    ✓ returns "ten" when given the input 10.01; ignore x.01 to x.09
    ✓ returns "zero" when given the input 0.00
    ✓ returns "zero" when given the input 000
    ✓ returns "three hundred thirty" when given the input 00330; corrected leading zeros
    ✓ returns "eighty eight.twenty" when given the input 088.200; corrected leading zeros and two decimal places

🚀 Hacks

Some of the features are not implemented for the sake of backward compatability between versions. Hey, but you can always find a way around..

Hard time passing it as a string? cast it from the source

const amount = 0.99
const convert = convert(`${amount}`) // template-literals will take care of casting it to a number

To eliminate commas

const regex = /,/g
const amount = '1,000.99'
const replaced = amount.replace(regex, '')

For some reason, if you want the decimal places not to be corrected, you can control it from your code

const amount = '123.123'
const [dollars, cents] = amount.split('.')
const result = `${convert(dollars)}.${convert(cents)}`