React-numero-extenso-formatacao

Escreve um numero por extenso e outras formatações

Como instalar

Abaixo as formas de como instalar essa biblioteca utilizando o npm ou yarn:

npm install react-formatacao-number-string
# ou
yarn add react-formatacao-number-string

Como usar

Uma forma básica de como utilizar o componente

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

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.5);
// 'dez vírgula cinco décimos'

numero.porExtenso(10.5, numero.estilo.monetario);
// 'dez reais e cinquenta centavos'

numero.porExtenso(10.5, numero.estilo.porcentagem);
// 'dez vírgula cinco décimos por cento'

numero.porExtenso(10.5, numero.estilo.agrario);
// 'dez metros quadrados e cinquenta decímetros quadrados'

numero.formataNumero(12523);
//formata numero para decimal: 12.523

numero.formataMoeda(1000.30);
//formata numero para moeda: 1.000,30

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'

const caminho = "C:Projetos/Arquivos/teste.kml";
numero.getExtensao(caminho);
//Retorna a extensão de um caminho: 'kml'

Propriedades

Esse componente é uma abstração de um componente input do tipo numérico, todas a propriedades de um input estão disponíveis.

| Propriedade | Estilos | Tipo | Descrição | | ------------- | -------------- | ------ | ---------------------------------- | | tipoExtenso | normal(padrão) | string | Formato de extensão do número | | tipoExtenso | monetário | string | Formato de extensão do monetário | | tipoExtenso | porcentagem | string | Formato de extensão da porcentagem | | tipoExtenso | agraria | string | Formato de extensão agrária | | formataNumero | numero inteiro | int | Retorna um double | | formataMoeda | numero inteiro | int | Retorna um string | | getExtensao | caminho string | string | Retorna a extensão (string) |