1.0.2 • Published 2 years ago

react-formatacao-number-string v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

React-numero-extenso-formatacao

npm NPM

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.

PropriedadeEstilosTipoDescrição
tipoExtensonormal(padrão)stringFormato de extensão do número
tipoExtensomonetáriostringFormato de extensão do monetário
tipoExtensoporcentagemstringFormato de extensão da porcentagem
tipoExtensoagrariastringFormato de extensão agrária
formataNumeronumero inteirointRetorna um double
formataMoedanumero inteirointRetorna um string
getExtensaocaminho stringstringRetorna a extensão (string)