Escrevendo número por extenso no PHP

Visualizações: 19.154 views

Tempo de Leitura: 3 minutos

Bom dia, queridos leitores!
Tudo bem com vocês?

Mais uma vez, estou trazendo uma função que uso em meus projetos, e a uso sempre que preciso escrever o valor de um número por extenso, o que não é uma situação tão incomum, não é verdade?

Adicionei 2 parâmetros booleanos opcionais

$bolExibirMoeda: Define se a função vai adicionar uma referência à moeda (centavos, real, etc)
$bolPalavraFeminina: Define se a função vai retornar duzentos ou duzentas, por exemplo.

Para filtrar melhor o parâmetro de entrada $valor, eu utilizei a função removerFormatacaoNumero, no qual já falei sobre ela aqui no blog, no post Removendo formatação de um número no PHP.

Como se costume, encapsulei a função numa classe e a criei de forma estática, para não precisar instanciar a classe sempre que eu precisar utilizar a função.

<?php
class clsTexto 
{
    
    public static function valorPorExtenso( $valor = 0, $bolExibirMoeda = true, $bolPalavraFeminina = false )
    {

        $valor = self::removerFormatacaoNumero( $valor );

        $singular = null;
        $plural = null;

        if ( $bolExibirMoeda )
        {
            $singular = array("centavo", "real", "mil", "milhão", "bilhão", "trilhão", "quatrilhão");
            $plural = array("centavos", "reais", "mil", "milhões", "bilhões", "trilhões","quatrilhões");
        }
        else
        {
            $singular = array("", "", "mil", "milhão", "bilhão", "trilhão", "quatrilhão");
            $plural = array("", "", "mil", "milhões", "bilhões", "trilhões","quatrilhões");
        }

        $c = array("", "cem", "duzentos", "trezentos", "quatrocentos","quinhentos", "seiscentos", "setecentos", "oitocentos", "novecentos");
        $d = array("", "dez", "vinte", "trinta", "quarenta", "cinquenta","sessenta", "setenta", "oitenta", "noventa");
        $d10 = array("dez", "onze", "doze", "treze", "quatorze", "quinze","dezesseis", "dezessete", "dezoito", "dezenove");
        $u = array("", "um", "dois", "três", "quatro", "cinco", "seis","sete", "oito", "nove");


        if ( $bolPalavraFeminina )
        {
        
            if ($valor == 1) 
            {
                $u = array("", "uma", "duas", "três", "quatro", "cinco", "seis","sete", "oito", "nove");
            }
            else 
            {
                $u = array("", "um", "duas", "três", "quatro", "cinco", "seis","sete", "oito", "nove");
            }
            
            
            $c = array("", "cem", "duzentas", "trezentas", "quatrocentas","quinhentas", "seiscentas", "setecentas", "oitocentas", "novecentas");
            
            
        }


        $z = 0;

        $valor = number_format( $valor, 2, ".", "." );
        $inteiro = explode( ".", $valor );

        for ( $i = 0; $i < count( $inteiro ); $i++ ) 
        {
            for ( $ii = mb_strlen( $inteiro[$i] ); $ii < 3; $ii++ ) 
            {
                $inteiro[$i] = "0" . $inteiro[$i];
            }
        }

        // $fim identifica onde que deve se dar junção de centenas por "e" ou por "," ;)
        $rt = null;
        $fim = count( $inteiro ) - ($inteiro[count( $inteiro ) - 1] > 0 ? 1 : 2);
        for ( $i = 0; $i < count( $inteiro ); $i++ )
        {
            $valor = $inteiro[$i];
            $rc = (($valor > 100) && ($valor < 200)) ? "cento" : $c[$valor[0]];
            $rd = ($valor[1] < 2) ? "" : $d[$valor[1]];
            $ru = ($valor > 0) ? (($valor[1] == 1) ? $d10[$valor[2]] : $u[$valor[2]]) : "";

            $r = $rc . (($rc && ($rd || $ru)) ? " e " : "") . $rd . (($rd && $ru) ? " e " : "") . $ru;
            $t = count( $inteiro ) - 1 - $i;
            $r .= $r ? " " . ($valor > 1 ? $plural[$t] : $singular[$t]) : "";
            if ( $valor == "000")
                $z++;
            elseif ( $z > 0 )
                $z--;
                
            if ( ($t == 1) && ($z > 0) && ($inteiro[0] > 0) )
                $r .= ( ($z > 1) ? " de " : "") . $plural[$t];
                
            if ( $r )
                $rt = $rt . ((($i > 0) && ($i < = $fim) && ($inteiro[0] > 0) && ($z < 1)) ? ( ($i < $fim) ? ", " : " e ") : " ") . $r;
        }

        $rt = mb_substr( $rt, 1 );

        return($rt ? trim( $rt ) : "zero");

    }
}
?>

<?php

class clsTexto

{

public static function valorPorExtenso( $valor = 0, $bolExibirMoeda = true, $bolPalavraFeminina = false )

{

$valor = self::removerFormatacaoNumero( $valor );

$singular = null;

$plural = null;

if ( $bolExibirMoeda )

{

$singular = array("centavo", "real", "mil", "milhão", "bilhão", "trilhão", "quatrilhão");

$plural = array("centavos", "reais", "mil", "milhões", "bilhões", "trilhões","quatrilhões");

}

else

{

$singular = array("", "", "mil", "milhão", "bilhão", "trilhão", "quatrilhão");

$plural = array("", "", "mil", "milhões", "bilhões", "trilhões","quatrilhões");

}

$c = array("", "cem", "duzentos", "trezentos", "quatrocentos","quinhentos", "seiscentos", "setecentos", "oitocentos", "novecentos");

$d = array("", "dez", "vinte", "trinta", "quarenta", "cinquenta","sessenta", "setenta", "oitenta", "noventa");

$d10 = array("dez", "onze", "doze", "treze", "quatorze", "quinze","dezesseis", "dezessete", "dezoito", "dezenove");

$u = array("", "um", "dois", "três", "quatro", "cinco", "seis","sete", "oito", "nove");

if ( $bolPalavraFeminina )

{

if ($valor == 1)

{

$u = array("", "uma", "duas", "três", "quatro", "cinco", "seis","sete", "oito", "nove");

}

else

{

$u = array("", "um", "duas", "três", "quatro", "cinco", "seis","sete", "oito", "nove");

}

$c = array("", "cem", "duzentas", "trezentas", "quatrocentas","quinhentas", "seiscentas", "setecentas", "oitocentas", "novecentas");

}

$z = 0;

$valor = number_format( $valor, 2, ".", "." );

$inteiro = explode( ".", $valor );

for ( $i = 0; $i < count( $inteiro ); $i++ )

{

for ( $ii = mb_strlen( $inteiro[$i] ); $ii < 3; $ii++ )

{

$inteiro[$i] = "0" . $inteiro[$i];

}

// $fim identifica onde que deve se dar junção de centenas por "e" ou por "," ;)

$rt = null;

$fim = count( $inteiro ) - ($inteiro[count( $inteiro ) - 1] > 0 ? 1 : 2);

for ( $i = 0; $i < count( $inteiro ); $i++ )

{

$valor = $inteiro[$i];

$rc = (($valor > 100) && ($valor < 200)) ? "cento" : $c[$valor[0]];

$rd = ($valor[1] < 2) ? "" : $d[$valor[1]];

$ru = ($valor > 0) ? (($valor[1] == 1) ? $d10[$valor[2]] : $u[$valor[2]]) : "";

$r = $rc . (($rc && ($rd || $ru)) ? " e " : "") . $rd . (($rd && $ru) ? " e " : "") . $ru;

$t = count( $inteiro ) - 1 - $i;

$r .= $r ? " " . ($valor > 1 ? $plural[$t] : $singular[$t]) : "";

if ( $valor == "000")

$z++;

elseif ( $z > 0 )

$z--;

if ( ($t == 1) && ($z > 0) && ($inteiro[0] > 0) )

$r .= ( ($z > 1) ? " de " : "") . $plural[$t];

if ( $r )

$rt = $rt . ((($i > 0) && ($i < = $fim) && ($inteiro[0] > 0) && ($z < 1)) ? ( ($i < $fim) ? ", " : " e ") : " ") . $r;

}

$rt = mb_substr( $rt, 1 );

return($rt ? trim( $rt ) : "zero");

}

Alguns exemplos de uso da função:

//Carregamos a classe para a memória
require_once("classes/clsTexto.php");

//Vai exibir na tela "um milhão, quatrocentos e oitenta e sete mil, duzentos e cinquenta e sete e cinquenta e cinco"
echo clsTexto::valorPorExtenso("R$ 1.487.257,55", false, false);

//Vai exibir na tela "um milhão, quatrocentos e oitenta e sete mil, duzentos e cinquenta e sete reais e cinquenta e cinco centavos"
echo clsTexto::valorPorExtenso("R$ 1.487.257,55", true, false);

//Vai exibir na tela "duas mil e setecentas e oitenta e sete"
echo clsTexto::valorPorExtenso("2787", false, true);

//Carregamos a classe para a memória

require_once("classes/clsTexto.php");

//Vai exibir na tela "um milhão, quatrocentos e oitenta e sete mil, duzentos e cinquenta e sete e cinquenta e cinco"

echo clsTexto::valorPorExtenso("R$ 1.487.257,55", false, false);

//Vai exibir na tela "um milhão, quatrocentos e oitenta e sete mil, duzentos e cinquenta e sete reais e cinquenta e cinco centavos"

echo clsTexto::valorPorExtenso("R$ 1.487.257,55", true, false);

//Vai exibir na tela "duas mil e setecentas e oitenta e sete"

echo clsTexto::valorPorExtenso("2787", false, true);

Tags: programação número extenso php

Alex Araújo disse:

22 de dezembro de 2022 às 01:51

Excelente código… Top!!
Mas… Eu tentei adaptar para valores maiores e não deu. Complementei os arrays de texto com quintilhão, sextilhão etc e suas versões no plural também, mas dá erro. Gostaria de utilizar até centilhão. Tem ideia de como poderia complementar de maneira adequada e correta? É para um projeto científico.

Responder
Lucão disse:

15 de setembro de 2022 às 10:58

Obrigado pela ajuda meu caro, você é sênior poderia me indicar uns cursos pls ?

Responder
Ednei Alencar disse:

22 de janeiro de 2021 às 14:18

preciso dessa função sem a parte dos reais. tipo 1.35 (Um ponto Trinta e Cinco)

Responder
Ricardo BS disse:

8 de janeiro de 2021 às 14:44

Esta com erro na linha 84.
PHP Parse error: syntax error, unexpected ‘=’ in /home/sigefonline/public_html/sigefonline/view/admin/classes/clsTexto.php on line 84

Responder
Dênis Fernandes disse:

10 de agosto de 2020 às 16:46

Muito obrigado por compartilhar este código! Rolou um syntax error, para corrigir eu fiz assim:
Na última linha, do último for temos um ternário com este trecho:
($i < = $fim)
trocamos por:
($i <= $fim)

Responder
MANUEL TAVARES disse:

21 de janeiro de 2020 às 12:28

boa tarde,
E se o número for decimal?
No código actual ele lê como se fosse inteiro? consegue ajudar?

Responder
Mamadu Boi Turé disse:

20 de janeiro de 2020 às 13:58

Muito obrigado, me ajudou muito.
Um abraço a partir da Guiné-Bissau em África.

Responder
Alex Junio Sapucaia Viana disse:

26 de dezembro de 2019 às 07:50

Conseguiu resolver , pois o meu , esta com o mesmo error.

Responder
Ralph Rangel disse:

4 de setembro de 2019 às 14:56

Valeu demais pelas duas funções

Responder
- Dirceu Resende disse:
  
  18 de setembro de 2019 às 22:58
  
  Obrigado, Ralph. Espero ter ajudado
  
  Responder
Vinicius Pessoa disse:

25 de julho de 2019 às 12:40

Será que fiz algo errado?
Parse error: syntax error, unexpected ‘=’ in C:\xampp\htdocs\moeda\clsTexto.php on line 85

$rt = $rt . ((($i > 0) && ($i 0) && ($z < 1)) ? ( ($i < $fim) ? ", " : " e ") : " ") . $r;

Responder
- Dirceu Resende disse:
  
  19 de setembro de 2019 às 00:29
  
  Conseguiu resolver? Se ainda tá com dificuldade, me chama no privado
  
  Responder
  - LOBATO disse:
    
    3 de março de 2023 às 14:53
    
    Estou com esse erro ai.
    
    Responder
Thiago Luís disse:

7 de fevereiro de 2019 às 20:48

Dirceu, muitíssimo obrigado por compartilhar!

Responder
Eder disse:

10 de janeiro de 2019 às 09:01

Favor corrigir o “dezessete”

Responder
- Dirceu Resende disse:
  
  10 de janeiro de 2019 às 21:46
  
  Fala Eder, beleza? Agora o “dezessete” está correto. 🙂
  Obrigado pela observação
  
  Responder
Dirceu Resende disse:

25 de junho de 2018 às 08:34

Olá Linces! Como você está ?

Conforme citado no início desse post, essa função está disponível no post https://www.dirceuresende.com/blog/removendo-formatacao-de-um-numero-no-php/

Qualquer dúvida, é só falar.

Responder
Linces disse:

24 de junho de 2018 às 17:04

PHP Fatal error: Uncaught Error: Call to undefined method clsTexto::removerFormatacaoNumero()

Responder
Adalberto Lima Vitorino (Beto Lima) disse:

24 de dezembro de 2017 às 18:51

Obrigado ! meu ajudou aqui

Responder
Fagner Maia disse:

12 de dezembro de 2017 às 08:52

Olá como se corrige esse erro que o marceltoniote falou acima

Responder
svicente99 disse:

19 de agosto de 2017 às 01:07

Vlw, amigo! Sua classe dei um “adianto” muito bom no meu projeto.
Ótimo traballho!
Boa sorte…

Responder
- Dirceu Resende disse:
  
  29 de agosto de 2017 às 20:26
  
  Obrigado pelo feedback, svicente99! Qualquer dúvida, é só falar.
  
  Responder
Jean Duarte disse:

19 de junho de 2017 às 19:32

Muito bom Dirceu, ajudou bastante.

Responder
Orlando Leite disse:

13 de abril de 2017 às 12:57

Olá, obrigado por disponibilizar o código. Este existe no github?
Segue um ajuste que precisei fazer:
Linha 89: return($rt ? trim( $rt ) : “zero”.($bolExibirMoeda ? ” reais e zero centavos” : “” ));

Responder
- Dirceu Resende disse:
  
  13 de abril de 2017 às 12:59
  
  Orlando, boa tarde.
  
  Obrigado pelo feedback. Esse código não está disponível no github, só aqui mesmo.
  
  Abraço!
  
  Responder
Marconi Rodrigues disse:

13 de março de 2017 às 17:25

No meu está dando o seguinte erro:

Fatal error: Call to undefined method extenso::removerFormatacaoNumero() in C:\Servidores_PHP\teste_mdl\extenso\extenso.php on line 10

Apenas troquei o nome da classe para ‘extenso’.

Agradeço uma ajuda desde já!

Responder
- Dirceu Resende disse:
  
  13 de março de 2017 às 18:48
  
  Marconi, você trocou o nome da classe também ou somente o nome do arquivo? Esse erro geralmente ocorre em objetos estáticos quando o nome da classe está errado ou o método não existe
  
  Responder
marceltoniote disse:

14 de fevereiro de 2017 às 09:01

Bom dia,

Amigo eu estou com esse erro:

Fatal error: Call to undefined method clsTexto::removerFormatacaoNumero() in D:\xampp\htdocs\escola2\classes\clsTexto.php on line 8

Responder
- marceltoniote disse:
  
  14 de fevereiro de 2017 às 09:34
  
  Ops falha minha, resolvido!
  
  Responder
  - Dirceu Resende disse:
    
    24 de fevereiro de 2017 às 06:52
    
    Tudo bem, Marcelo. Qualquer dúvida é só me avisar.
    
    Responder
edinaldoFox disse:

2 de agosto de 2016 às 15:38

Galera tem uma lib muito boa que faz a mesma coisa só que diferente. segue os links:

github: https://github.com/malukenho/speaknumber
packages: https://packagist.org/packages/malukenho/speaknumber

OBS: não estou desmerecendo o trabalho do amigo, só estou dando uma nova alternativa de uma lib.

Responder
- Dirceu Resende disse:
  
  2 de agosto de 2016 às 17:18
  
  Edinaldo, obrigado pela visita e pela dica dessa lib. Acredito que a solução do post seja mais simples de implementar, mas essa lib que você compartilhou me parece ser mais completa.
  
  Valeu!
  
  Responder
body_of_rays disse:

20 de fevereiro de 2015 às 08:21

Max, você pode alterar o retorno da função e utilizar a função ucfirst:

Exemplo: return($rt ? ucfirst(strtolower(trim( $rt ))) : “zero”);

Responder
- antimaxbr disse:
  
  21 de fevereiro de 2015 às 16:36
  
  É verdade… nem tinha lembrado disso. Muito obrigado.!
  
  Responder
Max disse:

20 de fevereiro de 2015 às 01:30

Muito bom. Como seria para capitalizar somente a primeira palavra?

Responder
Uheliton disse:

17 de fevereiro de 2015 às 18:17

Obrigado meu amigo, me ajudou muito.

Responder
Andre "acidcode" Gomes disse:

18 de dezembro de 2014 às 11:08

Obrigado pelo snippet, vai me ser muito util

Responder
- Ricardo BS disse:
  
  8 de janeiro de 2021 às 14:18
  
  não consegui usar nao.
  
  Responder

Assinar blog por e-mail

Visualizações do Blog

Microsoft MVP

Arquivo de Posts

Categorias

Posts recentes

Escrevendo número por extenso no PHP

You may also like...

38 Responses

Deixe uma respostaCancelar resposta

You may also like...

Lendo e escrevendo arquivos texto no PHP

Removendo formatação de um número no PHP

SQL Server – Como fazer uma integração com FTP e listar, enviar (upload) e baixar (download) arquivos utilizando o CLR (C#)

38 Responses

Deixe uma respostaCancelar resposta