currency-in-words

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') // seven hundred seventy seven
//  or
const result = convert('777', { format: 'in' }) // seven hundred seventy seven

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

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

1. Expect NaN when ',' is present, eg: '100,000.99'
2. Decimals are corrected to two places

Precision

---

Supports upto 15 digits for both indian and international systems on their integer part. A RangeError will be thrown for length beyond 15.

eg: calling convert with 100,000,000,000,000 * 10 will throw an error

International system:

999,999,999,999,999 (1 quadrillion - 1)

Indian system:

99,99,99,99,99,99,999 (100 crore crore - 1)

:rocket: 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 result = convert(`${amount}`) //  zero.ninety nine

To eliminate commas

const amount = '1,000.99'
const sanitized = amount.replace(/,/, '') //  1000.99

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

const amount = '123.123'
const [dollars, cents] = amount.split('.')
const result = `${convert(dollars)}.${convert(cents)}` // one hundred twenty threee.one hundred twenty three