phputil/extenso

Conversão de valores por extenso PHP

v3.0.0 2025-04-30 17:17 UTC

Requires

• php: >=7.4

Requires (Dev)

• kahlan/kahlan: ^6.0

LGPL-3.0-or-later

• Thiago Delgado Pinto

• extenso
• valor
• valores

README

extenso

Conversão de valores por extenso em PHP

• 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

Versão para PHP 8.x:

composer require phputil/extenso

Versão para PHP 5.4 até 7.x:

composer require phputil/extenso@2

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

Uso com classe Extenso:

require_once 'vendor/autoload.php';

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 );

Uso com funções - versão 2.1 ou posterior:

require_once 'vendor/autoload.php';

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

Veja também

Bibliotecas de código que podem lhe ser úteis:

• phputil/tdatetime - Manipulação de datas e horas
• phputil/json - Manipulação de formato JSON
• phputil/router - Construção de APIs RESTful como no ExpressJS
• phputil/rtti - Extração de informações de objetos em tempo de execução
• mais...

Licença

LGPL © Thiago Delgado Pinto