nl_langinfo

metaphone

Last updated: Fri, 22 Aug 2008

money_format

(PHP 4 >= 4.3.0, PHP 5)

money_format — Da formato a un número como una cadena de moneda

Descripción

string money_format ( string $formato , float $numero )

money_format() devuelve una versión con formato de numero . Esta función envuelve la función de la biblioteca de C strfmon(), con la diferencia de que esta implementación convierte solo un número a la vez.

Lista de parámetros

formato

La especificación de formato consiste de la siguiente secuencia:

un caracter %
banderas opcionales
un ancho de campo opcional
precisión de izquierda opcional
precisión de derecha opcional
un caracter de conversión, requerido

Banderas

Una o más de las siguientes banderas opcionales pueden ser usadas:

=f: El caracter = seguido de un caracter (byte sencillo) f que será usado como el caracter de relleno numérico. Es caracter de relleno predeterminado es el espacio.
^: Deshabilitar el uso de caracteres de agrupamiento (tal y como estén definidos según la localidad actual).
+ o (: Especifica el estilo de formato para números positivos y negativos. Si se usa +, los equivalentes de + y - en la localidad actual serán usados. Si se usa (, las cantidades negativas estarán ubicadas entre paréntesis. Si no se da especificación alguna, el valor por defecto es +.
!: Elimina el símbolo de moneda de la cadena de salida.
-: Si se encuentra presente, hará que todos los campos estén justificados a izquierda (con relleno a la derecha), en contraste al comportamiento predeterminado que hace que los campos estén justificados a derecha (con relleno a la izquierda).

Ancho de campo

w: Una cadena de dígito decimal que especifica un ancho de campo mínimo. El campo será justificado a derecha a menos que la bandera - sea usada. El valor predeterminado es 0 (cero).

Precisión de izquierda

#n

El número máximo de dígitos (n) a esperar a la izquerda del caracter decimal (p. ej. el punto decimal). Usualmente se usa para mantener la salida con formato alineada en las mismas columnas, usando el caracter de relleno si el número de dígitos es menor que n. Si el número de dígitos real es mayor que n, entonces esta especificación es ignorada.

Si no se ha suprimido el agrupamiento usando la bandera ^, los separadores de agrupamiento serán insertados antes de que los caracteres de relleno (si los hay) sean agregados. Los separadores de agrupamiento no serán aplicados sobre los caracteres de relleno, aun si el caracter de relleno es un dígito.

Para asegurar el alineamiento, cualquier caracter que aparezca antes o después del número en la salida con formato, tales como los símbolos de moneda o de signo, son rellenados en tanto sea necesario con caracteres de espacio para hacer que sus formatos positivo y negativo tengan una misma longitud.

Precisión de derecha

.p: Un punto seguido del número de dígitos (p) después del caracter decimal. Si el valor de p es 0 (cero), el caracter decimal y los dígitos a su derecha serán omitidos. Si no se incluye ninguna precisión de derecha, el valor predeterminado será determinado por la localidad en uso. La cantidad a la cual se está dando formato es redondeada al número de dígitos especificado antes del formato.

Caracteres de conversión

i: El número recibe formato de acuerdo al formato de moneda internacional de la localidad (p.ej. para la localidad de USA: USD 1,234.56).
n: El número recibe formato de acuerdo al formato de moneda nacional de la localidad (p.ej. para la localidad de_DE: DM1.234,56).
%: Devuelve el caracter %.

numbero

El número a ser formateado.

Valores retornados

Devuelve la cadena con formato. Los caracteres antes y después de la cadena de formato serán regresados sin modificar.

Notes

Note: La función money_format() está definida solo si el sistema tiene la capacidad de llamar a strfmon. Por ejemplo, Windows no tiene soporte para esta función, así que money_format() no se encuentra definida en Windows.

Note: La categoría LC_MONETARY de los parámetros de la localidad, afecta el comportamiento de esta función. Use setlocale() para establecer la localidad predeterminada apropiada antes de usar esta función.

Ejemplos

Example #1 Ejemplo de money_format()

Usaremos diferentes localidades y especificaciones de formato para ilustrar el uso de esta función.


<?php

$numero = 1234.56;

// imprimamos el formato internacional para la localidad en_US
setlocale(LC_MONETARY, 'en_US');
echo money_format('%i', $numero) . "\n";
// USD 1,234.56

// Formato nacional italiano con 2 decimales
setlocale(LC_MONETARY, 'it_IT');
echo money_format('%.2n', $numero) . "\n";
// L. 1.234,56

// Uso de un número negativo
$numero = -1234.5672;

// Formato nacional de US, usando () para números negativos
// y 10 dígitos para la precisión de derecha
setlocale(LC_MONETARY, 'en_US');
echo money_format('%(#10n', $numero) . "\n";
// ($        1,234.57)

// Un formato similar al anterior, agregando el uso de 2 dígitos de
// precisión de derecha y '*' como caracter de relleno
echo money_format('%=*(#10.2n', $numero) . "\n";
// ($********1,234.57)

// Justifiquemos a izquierda, con 14 posiciones de ancho, 8 dígitos de
// precisión de izquierda, 2 de precisión de derecha, sin caracter de
// agrupamiento y usando el formato internacional de la localidad
// de_DE.
setlocale(LC_MONETARY, 'de_DE');
echo money_format('%=*^-14#8.2i', 1234.56) . "\n";
// DEM 1234,56****

// Agreguemos un poco de información antes y despues de la especificación
// de conversión
setlocale(LC_MONETARY, 'en_GB');
$fmt = 'El valor final es %i (después de un descuento de 10%%)';
echo money_format($fmt, 1234.56) . "\n";
// El valor final es GBP 1,234.56 (después de un descuento de 10%)

?>

Ver también

nl_langinfo

metaphone

Last updated: Fri, 22 Aug 2008

add a note User Contributed Notes
money_format

jeremy
30-Sep-2008 07:41


If money_format doesn't seem to be working properly, make sure you are defining a valid locale.  For example, on Debian, 'en_US' is not a valid locale - you need 'en_US.UTF-8' or 'en_US.ISO-8559-1'.



This was frustrating me for a while.  Debian has a list of valid locales at /usr/share/i18n/SUPPORTED; find yours there if it's not working properly.

chris () xeneco co-uk
18-Aug-2008 03:39


Thank you to Rafael M. Salvioni for your winXP implementation.



When using Rafael's function a reference is made to localeconv() and extracts the currency_symbol.....



I have found that if I set the charset of my web pages to UTF-8 and attempt to display the currency_symbol then I get an unknown character.



Changing the charset to ISO-8859-1 resolves the issue



[tested PHP 5.2.6, winXP Apache 2]

Pradeep Gond
13-Aug-2008 01:00


@  swapnet (22-Jul-2008 08:24)



Your code will fail to convert 1000000. It will convert to 10,0,000. Only the first token from the split should be int typecasted, as this might have a leading zero. Here is the fixed version:



<?php

function convertcash($num, $currency){

    if(strlen($num)>3){

            $lastthree = substr($num, strlen($num)-3, strlen($num));

            $restunits = substr($num, 0, strlen($num)-3); // extracts the last three digits

            $restunits = (strlen($restunits)%2 == 1)?"0".$restunits:$restunits; // explodes the remaining digits in 2's formats, adds a zero in the beginning to maintain the 2's grouping.



            $expunit = str_split($restunits, 2);



            if(sizeof($expunit) >= 1) {

              $explrestunits .= (int)$expunit[0].","; // int typecaste to get rid of the possible leading zero.

            }            



            for($i=1; $i<sizeof($expunit); $i++){

                $explrestunits .= $expunit[$i].","; // creates each of the 2's group and adds a comma to the end

            }   



            $thecash = $explrestunits.$lastthree;

    } else {

           $thecash = $convertnum;

    }

   

    return $currency.$thecash.".00"; // writes the final format where $currency is the currency symbol.

}

?>

swapnet
23-Jul-2008 05:24


Consider formatting currency for some South Asian countries that use ##,##,###.## money format.


The following code generates something like Rs. 4,54,234.00 and so on.





<?php


function convertcash($num, $currency){


    if(strlen($num)>3){


            $lastthree = substr($num, strlen($num)-3, strlen($num));


            $restunits = substr($num, 0, strlen($num)-3); // extracts the last three digits


            $restunits = (strlen($restunits)%2 == 1)?"0".$restunits:$restunits; // explodes the remaining digits in 2's formats, adds a zero in the beginning to maintain the 2's grouping.





            $expunit = str_split($restunits, 2);


            for($i=0; $i<sizeof($expunit); $i++){


                $explrestunits .= (int)$expunit[$i].","; // creates each of the 2's group and adds a comma to the end


            }    





            $thecash = $explrestunits.$lastthree;


    } else {


           $thecash = $convertnum;


    }


    


    return $currency.$thecash.".00"; // writes the final format where $currency is the currency symbol.


}


?>





now call the function as  convertcash($row['price'], 'Rs '); // that's the price from the database I called using an Indian Rupees prefix where the price has to be a plain number format, say something like 454234.

Rafael M. Salvioni
18-Mar-2008 10:31


<?php

/*

That it is an implementation of the function money_format for the

platforms that do not it bear.  



The function accepts to same string of format accepts for the

original function of the PHP.  



(Sorry. my writing in English is very bad)  



The function is tested using PHP 5.1.4 in Windows XP

and Apache WebServer.

*/

if (!function_exists('money_format')) {

    function money_format($format, $number)

    {

        $regex  = array(

           '/%((?:[\^!\-]|\+|\(|\=.)*)([0-9]+)?(?:#([0-9]+))?',

           '(?:\.([0-9]+))?([in%])/'

        );

        $regex = implode('', $regex);

        if (setlocale(LC_MONETARY, null) == '') {

            setlocale(LC_MONETARY, '');

        }

        $locale = localeconv();

        $number = floatval($number);

        if (!preg_match($regex, $format, $fmatch)) {

            trigger_error("No format specified or invalid format",

E_USER_WARNING);

            return $number;

        }

        $flags = array(

            'fillchar'  => preg_match('/\=(.)/', $fmatch[1], $match) ?

$match[1] : ' ',

            'nogroup'   => preg_match('/\^/', $fmatch[1]) > 0,

            'usesignal' => preg_match('/\+|\(/', $fmatch[1], $match) ?

$match[0] : '+',

            'nosimbol'  => preg_match('/\!/', $fmatch[1]) > 0,

            'isleft'    => preg_match('/\-/', $fmatch[1]) > 0

        );

        $width      = trim($fmatch[2]) ? (int)$fmatch[2] : 0;

        $left       = trim($fmatch[3]) ? (int)$fmatch[3] : 0;

        $right      = trim($fmatch[4]) ? (int)$fmatch[4] :

$locale['int_frac_digits'];

        $conversion = $fmatch[5];

        $positive = true;

        if ($number < 0) {

            $positive = false;

            $number  *= -1;

        }

        $letter = $positive ? 'p' : 'n';

        $prefix = $suffix = $cprefix = $csuffix = $signal = '';

        if (!$positive) {

            $signal = $locale['negative_sign'];

            switch (true) {

                case $locale['n_sign_posn'] == 0 || $flags['signal'] ==

'(':

                    $prefix = '(';

                    $suffix = ')';

                    break;

                case $locale['n_sign_posn'] == 1:

                    $prefix = $signal;

                    break;

                case $locale['n_sign_posn'] == 2:

                    $suffix = $signal;

                    break;

                case $locale['n_sign_posn'] == 3:

                    $cprefix = $signal;

                    break;

                case $locale['n_sign_posn'] == 4:

                    $csuffix = $signal;

                    break;

            }

        }

        if (!$flags['nosimbol']) {

            $currency  = $cprefix;

            $currency .= (

                $conversion == 'i' ?

                $locale['int_curr_symbol'] :

                $locale['currency_symbol']

            );

            $currency .= $csuffix;

        } else {

            $currency = '';

        }

        $space    = $locale["{$letter}_sep_by_space"] ? ' ' : '';

        

        $number = number_format($number, $right,

$locale['mon_decimal_point'],

                      $flags['nogroup'] ? '' :

$locale['mon_thousands_sep']

                  );

        $number = explode($locale['mon_decimal_point'], $number);

        

        $n = strlen($prefix) + strlen($currency);

        if ($left > 0 && $left > $n) {

            if ($flags['isleft']) {

                $number[0] .= str_repeat($flags['fillchar'], $left - $n);

            } else {

                $number[0] = str_repeat($flags['fillchar'], $left - $n) .

$number[0];

            }

        }

        $number = implode($locale['mon_decimal_point'], $number);

        if ($locale["{$letter}_cs_precedes"]) {

            $number = $prefix . $currency . $space . $number . $suffix;

        } else {

            $number = $prefix . $number . $space . $currency . $suffix;

        }

        if ($width > 0) {

            $number = str_pad($number, $width, $flags['fillchar'],

$flags['isleft'] ? STR_PAD_RIGHT : STR_PAD_LEFT);

        }

        $format = str_replace($fmatch[0], $number, $format);

        return $format;

    }

}



?>

scot from ezyauctionz.co.nz
06-Oct-2007 12:10


This is a handy little bit of code I just wrote, as I was not able to find anything else suitable for my situation.

This will handle monetary values that are passed to the script by a user, to reformat any comma use so that it is not broken when it passes through an input validation system that checks for a float.



It is not foolproof, but will handle the common input as most users would input it, such as 1,234,567 (outputs 1234567) or 1,234.00 (outputs 1234.00), even handles 12,34 (outputs 12.34), I expect it would work with negative numbers, but have not tested it, as it is not used for that in my situation.



This worked when other options such as money_format() were not suitable or possible.



===============



///////////////

// BEGIN CODE convert all price amounts into well formatted values

function converttonum($convertnum,$fieldinput){

        $bits = explode(",",$convertnum); // split input value up to allow checking

        

        $first = strlen($bits[0]); // gets part before first comma (thousands/millions)

        $last = strlen($bits[1]); // gets part after first comma (thousands (or decimals if incorrectly used by user)

        

        if ($last <3){ // checks for comma being used as decimal place

            $convertnum = str_replace(",",".",$convertnum);

        }

        else{ // assume comma is a thousands seperator, so remove it

            $convertnum = str_replace(",","",$convertnum);

        }

        

        $_POST[$fieldinput] = $convertnum; // redefine the vlaue of the variable, to be the new corrected one

}



@converttonum($_POST[inputone],"inputone");

@converttonum($_POST[inputtwo],"inputtwo");

@converttonum($_POST[inputthree],"inputthree");

// END CODE

//////////////



================



This is suitable for the English usage, it may need tweaking to work with other types.

winkjr at sound-o-mat dot com
29-Jul-2007 03:42


Agreed, be sure to check that money_format() is defined at all for your version of PHP.  I have PHP 4.4.5 w/dev. packages built from source tarballs and it's not defined.  I think the docs are wrong, and it's only available in PHP 5.x.

richard dot selby at uk dot clara dot net
17-Feb-2006 04:02


Double check that money_format() is defined on any version of PHP you plan your code to run on.  You might be surprised.



For example, it worked on my Linux box where I code, but not on  servers running  BSD 4.11 variants. (This is presumably because strfmon  is not defined - see note at the top of teis page). It's not just a windows/unix issue.

www dot spam at whoah dot net
26-Aug-2004 03:33


For users of Windows looking for basic number formatting such as decimal places, decimal seperator and thousands seperators use number_format() instead.



http://www.php.net/number_format

add a note

nl_langinfo

metaphone

Last updated: Fri, 22 Aug 2008