phputil/extenso

Conversão de valores por extenso PHP

v2.1.2 2024-04-02 19:58 UTC

This package is auto-updated.

Last update: 2024-05-02 20:05:08 UTC


README

Build Status Version Downloads

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:

Licença

LGPL © Thiago Delgado Pinto