Description

Simple process in order to translate numbers to texts using spanish rules on cardinal numbering.

• See more in https://www.rae.es/dpd/cardinales

Process considers forms 'apocopate' (apocopado) and gender using options provided to translate method.

Restrictions

• Number to translate is using only integer part in order to translate.
• Compatible for numbers between [0 ... 999.999.999.999] (1 billion - 1)

Next versions

• Simplify translate process
• Decimal parts
• Automatic pluralization

Installation

npm install --save numero-a-texto

Use

# default translator
const { numToText } = require('numero-a-texto')

numToText.translate(154821)
# Numeric form
# 'Ciento cincuenta y cuatro mil ochocientos veintiuno'

numToText.translate(154821, { suffix: 'pesos'})
# Cardinal
# 'Ciento cincuenta y cuatro mil ochocientos veintiún pesos'

numToText.translate(154821, { suffix:'personas', gender: 'F' })
# Cardinal using female gender
# 'Ciento cincuenta y cuatro mil ochocientas veintiuna personas'