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-numero-texto
# ou
yarn add react-formatacao-numero-texto
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,30Nú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) |
