# numero-por-extenso

> Escreve números por extenso: normais, monetários e porcentagens.

Latest version **1.0.8** (published 2020-02-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install numero-por-extenso
pnpm add numero-por-extenso
yarn add numero-por-extenso
bun add numero-por-extenso
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.8 |
| Published | 2020-02-20 |
| First published | 2018-04-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 14.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30 |
| Author | Lenon Bordini |
| Maintainers | lenonbordini |
| Keywords | numero, extenso, numero por extenso, escrever numero, monetario, porcentagem, escrever numero monetario |

## Links

- npm: https://www.npmjs.com/package/numero-por-extenso
- Repository: https://github.com/LenonBordini/numero-por-extenso
- Homepage: https://github.com/LenonBordini/numero-por-extenso#readme
- Issues: https://github.com/LenonBordini/numero-por-extenso/issues
- npm.io page: https://npm.io/package/numero-por-extenso

## Alternatives

- [lodash.startswith](https://npm.io/package/lodash.startswith.md) — 769.7K weekly downloads
- [@tarojs/service](https://npm.io/package/@tarojs/service.md) — 33.9K weekly downloads
- [io.extendreality.tilia.indicators.spatialtargets.unity](https://npm.io/package/io.extendreality.tilia.indicators.spatialtargets.unity.md) — 131 weekly downloads
- [@rtarojs/taro](https://npm.io/package/@rtarojs/taro.md) — 90 weekly downloads
- [node-branch-io](https://npm.io/package/node-branch-io.md) — 50 weekly downloads

## Recent versions

- 1.0.8 (latest) — 2020-02-20
- 1.0.7 — 2019-12-11
- 1.0.6 — 2019-12-03
- 1.0.5 — 2018-07-19
- 1.0.4 — 2018-06-05
- 1.0.3 — 2018-04-20
- 1.0.2 — 2018-04-20
- 1.0.1 — 2018-04-20
- 1.0.0 — 2018-04-20

## README

# Número por extenso

[![Build Status](https://travis-ci.org/LenonBordini/numero-por-extenso.svg?branch=master)](https://travis-ci.org/LenonBordini/numero-por-extenso)

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

---

## Instalação

```shell
npm i numero-por-extenso
```

---

## Uso

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

### Estilos existentes

- normal (padrão)
- monetario
- porcentagem

### Exemplos

Números inteiros:

```js
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:

```js
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:

```js
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

---
_Source: https://npm.io/package/numero-por-extenso · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._