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

Dependencies (0)

    Dev Dependencies (2)

    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