numero-por-extenso

1.0.8 • Public • Published

Número por extenso

Build Status

Escreve números por extenso: normais, monetários e porcentagens. Fácil implementação de novos tipos.


Instalação

npm i numero-por-extenso

Uso

const numero = require('numero-por-extenso');

Estilos existentes

  • normal (padrão)
  • monetario
  • porcentagem

Exemplos

Números inteiros:

numero.porExtenso(128);
// 'cento e vinte e oito'
 
numero.porExtenso(128, numero.estilo.monetario);
// 'cento e vinte e oito reais'
 
numero.porExtenso(128, numero.estilo.porcentagem);
// 'cento e vinte e oito por cento'

Números decimais:

numero.porExtenso(10.50);
// 'dez vírgula cinco décimos'
 
numero.porExtenso(10.50, numero.estilo.monetario);
// 'dez reais e cinquenta centavos'
 
numero.porExtenso(10.50, numero.estilo.porcentagem);
// 'dez vírgula cinco décimos por cento'

Números gigantes:

numero.porExtenso(9_876_543_210);
// 'nove bilhões oitocentos e setenta e seis milhões quinhentos e quarenta e três mil duzentos e dez'
 
numero.porExtenso(-87_654_321, numero.estilo.monetario);
// 'menos oitenta e sete milhões seiscentos e cinquenta e quatro mil trezentos e vinte e um reais'
 
numero.porExtenso(123_456.7891, numero.estilo.porcentagem);
// 'cento e vinte e três mil quatrocentos e cinquenta e seis vírgula sete mil oitocentos e noventa e um décimos de milésimo por cento'

Maior número possível (type number):

  • 999_999_999_999_999.9

Maior número possível (type string):

  • '999999999999999999999999999999999999999999999.99999999999999999999'

Licença

MIT License - Copyright (c) 2020 Lenon Bordini

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.0.8
    1,396
    • latest

Version History

Package Sidebar

Install

npm i numero-por-extenso

Weekly Downloads

1,441

Version

1.0.8

License

MIT

Unpacked Size

15.1 kB

Total Files

14

Last publish

Collaborators

  • lenonbordini