r00tr41z/numeroporextenso

Converte numeral em valor por extenso.

v1.0.0 2024-01-19 23:20 UTC

Requires (Dev)

• phpunit/phpunit: 8.5.x-dev

MIT

• RootRaiz

• extenso
• numero
• moeda

README

Converte numeros em valor por extenso.

Suporte para as seguintes moedas:

• Metical - Moçambicano
• Real - Brazileiro
• Euro - Portugues
• Kwanza - Angolano

Como usar:

https://packagist.org/packages/r00tr41z/numeroporextenso

composer require r00tr41z/numeroporextenso

#Metical

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$extenso = new NumeroPorExtenso('metical')
$extenso = $extenso->converter(123.45);
echo $extenso;
// cento e vinte três meticais e quarenta cinco centavos

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$vazio = new NumeroPorExtenso('metical')
$vazio = $extenso->converter();
echo $vazio;
// Informe um numeral.

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$negativo = new NumeroPorExtenso('metical');
$negativo = $extenso->converter(-1);
echo $negativo;
// O numeral deve ser maior que zero.

#real

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$extenso = new NumeroPorExtenso('real')
$extenso = $extenso->converter(123.45);
echo $extenso;
// cento e vinte três reais e quarenta cinco centavos

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$vazio = new NumeroPorExtenso('real')
$vazio = $extenso->converter();
echo $vazio;
// Informe um numeral.

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$negativo = new NumeroPorExtenso('real');
$negativo = $extenso->converter(-1);
echo $negativo;
// O numeral deve ser maior que zero.

#Euro

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$extenso = new NumeroPorExtenso('euro')
$extenso = $extenso->converter(123.45);
echo $extenso;
// cento e vinte três euros e quarenta cinco centavos

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$vazio = new NumeroPorExtenso('euro')
$vazio = $extenso->converter();
echo $vazio;
// Informe um numeral.

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$negativo = new NumeroPorExtenso('euro');
$negativo = $extenso->converter(-1);
echo $negativo;
// O numeral deve ser maior que zero.

#Kwanza

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$extenso = new NumeroPorExtenso('kwanza');
$extenso = $extenso->converter(123.45);
echo $extenso;
// cento e vinte três kwanzas e quarenta cinco centavos

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$vazio = new NumeroPorExtenso('kwanza')
$vazio = $extenso->converter();
echo $vazio;
// Informe um numeral.

include __DIR__.'/vendor/autoload.php';

use R00TR41Z\NumeroExtenso\NumeroPorExtenso;

$negativo = new NumeroPorExtenso('kwanza');
$negativo = $extenso->converter(-1);
echo $negativo;
// O numeral deve ser maior que zero.

Exemplos:

Consulte o arquivo https://github.com/R00TR41Z/numeroporextenso/blob/master/example/index.php

Creditos

https://github.com/wgenial

Note: Esse pacote é uma replica da versão original https://github.com/wgenial/numeroporextenso-php

Afinal, o que é um número por extenso?

"Um número por extenso é a forma como um número qualquer é representado em determinada língua sem a utilização de algarismos, através de palavras ou combinação de palavras que representam os números, como por exemplo" Wikipédia