Writing full number in PHP

Views: 17.623 views

Reading Time: 3 minutes

Good morning, dear readers!
All right with you?

Again, I'm bringing a function that I use in my projects, and I use it whenever I need to write the value of a number in full, which is not such an unusual situation, is it true?

Added 2 optional boolean parameters

$ bolView Currency: Defines if the function will add a currency reference (cents, real, etc)
$ bolWordFeminine: Defines whether the function will return two hundred or two hundred, for example.

To better filter the input parameter $ value, I used the function removeFormatNumber, which I talked about her here on the blog, in the post Removing Number Formatting in PHP.

As usual, I encapsulated the function in a class and created it statically, so I didn't have to instantiate the class whenever I needed to use the function.

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

}

Some examples of using the function:

//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: extensive number php programming

Alex Araujo said:

December 22 from 2022 to 01: 51

Excellent code… Top!!
But… I tried to adapt to higher values and it didn't work. I complemented the text arrays with quintillion, sextillion etc and their plural versions too, but it gives an error. I would like to use up to centillion. Do you have any idea how you could complement it properly and correctly? It's for a science project.

Reply
lucão said:

15 from 2022 from September to 10: 58

Thanks for the help my dear, you are senior could you recommend me some courses pls?

Reply
Ednei Alencar said:

22 January 2021 to 14: 18

I need this function without the real part. type 1.35 (one point thirty-five)

Reply
Ricardo BS said:

8 January 2021 to 14: 44

It is in error on line 84.
PHP Parse error: syntax error, unexpected '=' in /home/sigefonline/public_html/sigefonline/view/admin/classes/clsTexto.php on line 84

Reply
Dennis Fernandes said:

10 from 2020 to 16 at 46: XNUMX

Thank you so much for sharing this code! There was a syntax error, to correct I did it like this:
In the last line, from the last for we have a ternary with this excerpt:
($ i <= $ end)
we exchange for:
($ i <= $ end)

Reply
MANUEL TAVARES said:

21 January 2020 to 12: 28

good afternoon,
What if the number is decimal?
In the current code does it read as if it were whole? can you help?

Reply
Mamadu Boi Turé said:

20 January 2020 to 13: 58

Thank you very much, it helped me a lot.
A hug from Guinea-Bissau in Africa.

Reply
Alex Junio Sapucaia Viana said:

December 26 from 2019 to 07: 50

It managed to solve, because mine, is with the same error.

Reply
Ralph Rangel said:

4 from 2019 from September to 14: 56

Thanks a lot for both functions

Reply
- Dirceu Resende said:
  
  18 from 2019 from September to 22: 58
  
  Thank you, Ralph. Hope this helps
  
  Reply
Vinicius Pessoa said:

25 July 2019 to 12: 40

Did I do something wrong?
Parse error: syntax error, unexpected '=' in C: \ xampp \ htdocs \ currency \ clsTexto.php on line 85

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

Reply
- Dirceu Resende said:
  
  19 from 2019 from September to 00: 29
  
  Managed to solve? If you're still having trouble, call me in the private
  
  Reply
  - LOBATO said:
    
    3 March 2023 to 14: 53
    
    I have this error there.
    
    Reply
Thiago Luís said:

7 February 2019 to 20: 48

Dirceu, thank you so much for sharing!

Reply
Eder said:

10 January 2019 to 09: 01

Please correct the “seventeen”

Reply
- Dirceu Resende said:
  
  10 January 2019 to 21: 46
  
  Eder speaks, ok? Now "seventeen" is correct. 🙂
  Thanks for the remark
  
  Reply
Dirceu Resende said:

25 June 2018 to 08: 34

Hello Bobcats! How are you ?

As mentioned at the beginning of this post, this function is available in the post. https://www.dirceuresende.com/blog/removendo-formatacao-de-um-numero-no-php/

If you have any questions, do not hesitate to ask.

Reply
Bobcats said:

24 June 2018 to 17: 04

PHP Fatal error: Uncaught Error: Call to undefined method clsText :: removeFormatNumber ()

Reply
Adalberto Lima Vitorino (Beto Lima) said:

December 24 from 2017 to 18: 51

Thanks ! my helped here

Reply
Mayan Fagner said:

December 12 from 2017 to 08: 52

Hello how do you correct this mistake that marceltoniote mentioned above

Reply
svicente99 said:

19 from 2017 to 01 at 07: XNUMX

Vlw, friend! Your class gave a very good “advance” in my project.
Great job!
Good luck…

Reply
- Dirceu Resende said:
  
  29 from 2017 to 20 at 26: XNUMX
  
  Thanks for the feedback, svicente99! If you have any questions, do not hesitate to ask.
  
  Reply
Jean Duarte said:

19 June 2017 to 19: 32

Very good Dirceu, helped a lot.

Reply
Orlando Leite said:

13 April 2017 12 gies: 57

Hello, thanks for making the code available. Does this exist on github?
Here's an adjustment I needed to make:
89 line: return ($ rt? Trim ($ rt): “zero”. ($ BolDisplay Currency? ”Reais and zero cents”: “”));

Reply
- Dirceu Resende said:
  
  13 April 2017 12 gies: 59
  
  Orlando, good afternoon.
  
  Thanks for the feedback. This code is not available on github, just right here.
  
  Hug!
  
  Reply
Marconi Rodrigues said:

13 March 2017 to 17: 25

In mine is giving the following error:

Fatal error: Call to undefined method extended :: removeFormatNumber () in C: \ PHP Servers \ test_mdl \ extended \ extended.php on line 10

I just changed the class name to 'extensive'.

Thanks for a help in advance!

Reply
- Dirceu Resende said:
  
  13 March 2017 to 18: 48
  
  Marconi, did you change the class name too or just the file name? This error usually occurs on static objects when the class name is wrong or the method does not exist.
  
  Reply
marceltoniote said:

14 February 2017 to 09: 01

Good morning,

Friend I have this error:

Fatal error: Call to undefined method clsText :: removeFormatNumber () in D: \ xampp \ htdocs \ school2 \ classes \ clsText.php on line 8

Reply
- marceltoniote said:
  
  14 February 2017 to 09: 34
  
  Oops my fault, solved!
  
  Reply
  - Dirceu Resende said:
    
    24 February 2017 to 06: 52
    
    Alright, Marcelo. Any questions just let me know.
    
    Reply
edinaldoFox said:

2 from 2016 to 15 at 38: XNUMX

Guys have a very good lib that does the same thing but different. Follow the links:

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

NOTE: I'm not downplaying the work of the friend, I'm just giving a new alternative of a lib.

Reply
- Dirceu Resende said:
  
  2 from 2016 to 17 at 18: XNUMX
  
  Edinaldo, thanks for visiting and for the tip of this lib. I think the post solution is simpler to implement, but this lib you shared seems to me to be more complete.
  
  Thanks!
  
  Reply
body_of_rays said:

20 February 2015 to 08: 21

Max, you can change the return of the function and use the ucfirst function:

Example: return ($ rt? Ucfirst (strtolower (trim ($ rt))): "zero");

Reply
- antimaxbr said:
  
  21 February 2015 to 16: 36
  
  It's true ... I hadn't even remembered that. Thank you.!
  
  Reply
Max said:

20 February 2015 to 01: 30

Very good. What would it be like to capitalize only the first word?

Reply
Uheliton said:

17 February 2015 to 18: 17

Thank you my friend, helped me a lot.

Reply
Andre "acidcode" Gomes said:

December 18 from 2014 to 11: 08

Thanks for the snippet, it will be very useful to me

Reply
- Ricardo BS said:
  
  8 January 2021 to 14: 18
  
  I couldn't use it.
  
  Reply

Other Languages

Subscribe to a blog by email

Blog Views

Power Alerts

Azure Banking Admin Course

SQL Server Security Course

My Certifications

Posts Archive

Categories

Recent Posts

Writing full number in PHP

You may also like ...

Comments

Leave a Comment Cancel reply

You may also like ...

Introduction to SQL Common Language Runtime (CLR) in SQL Server

Adding and subtracting dates and times in PHP

Exporting query data to CSV using Firebird (Interbase) and PHP

Comments

Leave a Comment Cancel reply