thiagodp/extenso

Conversão de valores por extenso para PHP >= 5.4

extenso

Conversão de valores por extenso em PHP (>= 5.4)

• Suporta números até a casa dos vigesilhões.
• Suporta casas decimais até vigesilhões.
• Verificado com testes automatizados.
• Usa Versionamento Semâtico.

Instalação

composer require phputil/extenso

Documentação

Estilos aceitos:

Estilo	Exemplo	Saída
MOEDA	1001	mil e um reais
NUMERO_MASCULINO	1001	mil e um
NUMERO_FEMININO	1001	mil e uma

Exemplos

use phputil\extenso\Extenso;

$e = new Extenso();
$e->extenso( 1001 ); // mil e um reais
$e->extenso( 1001, Extenso::MOEDA ); // mil e um reais
$e->extenso( 1001, Extenso::NUMERO_MASCULINO ); // mil e um
$e->extenso( 1001, Extenso::NUMERO_FEMININO ); // mil e uma

$e->extenso( 1001.01 ); // mil e um reais e um centavo
$e->extenso( 1001.001 ); // mil e um reais e um milésimo

// quatro milhões vinte e cinco mil oitocentos reais e noventa e nove centavos
$e->extenso( 4025800.99 );

Usando funções

⚠ Suportado na versão 2.1 ou posterior

use phputil\extenso\extenso;
use phputil\extenso\moeda;
use phputil\extenso\masculino;
use phputil\extenso\feminino;

extenso( 1001 );   // mil e um reais
moeda( 1001 );     // mil e um reais
masculino( 1001 ); // mil e um
feminino( 1001 );  // mil e uma

Outras

Outras bibliotecas de código que podem ser úteis:

• phputil/tdatetime
• phputil/json
• phputil/router
• phputil/rtti
• mais...

Licença

LGPL © Thiago Delgado Pinto

extenso's Issues

Não utilizar conjunção entre os milhares e as centenas quando o número acaba nas dezenas ou nas unidades e a centenas não são nulas

https://www.normaculta.com.br/numeros-por-extenso/#:~:text=Em%20textos%20escritos%2C%20devem%20ser,bem%20como%20os%20numerais%20fracion%C3%A1rios.

Exemplo:
O "e" em negrito não deve existir.
499.999,00
Está retornando: quatrocentos e noventa e nove mil e novecentos e noventa e nove reais
Deve retornar: quatrocentos e noventa e nove mil novecentos e noventa e nove reais