PHP
downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

nl_langinfo> <metaphone
Last updated: Fri, 18 Jul 2008

view this page in

money_format

(PHP 4 >= 4.3.0, PHP 5)

money_format — Formattazione di un numero come stringa monetaria

Descrizione

string money_format ( string $format , float $number )

money_format() restituisce una versione formattata di number . Questa funzione è un'interfaccia alla funzione C strfmon(), con la differenza che questa funzione converte un solo numero alla volta.

Nota: La funzione money_format() esiste solo se il sistema suppporta strfmon. Ad esempio, Windows non lo supporta perciò la funzione money_format() non è definita su Windows.

LA specifica del formato consiste nella seguente sequenza:

  • un carattere %

  • un flag opzionale flags

  • la lunghezza del campo, opzionale

  • la precisione a sinistra, opzionale

  • la precisione a destra, opzionale

  • un carattere di conversione, obbligatorio

Flag

Si possono utilizzare uno o più dei seguenti flag:

=f

Il carattere = seguito da un singolo carattere (singolo byte) f è utilizzato come carattere di riempimento numerico. Il carattere di default è lo spazio.

^

Disabilita l'utilizzo del raggruppamento dei caratetrei (come definito nelle impostazioni locali).

+ oppure (

Specifica lo stile di formattazione per i numeri positivi e negativi. Se si utilizza +, sarà utilizzato l'equivalente valore locale per + e -. Se si utilizza (, i valori negativi saranno racchiusi tra parentesi. Se non si da specifica, il default è +.

!

Sopprime il simbolo della moneta nella stringa di output.

-

Se presente, rende tutti i campi giustificati a sinistra (riempiti a a destra), il default prevede i campi allineati a destra (riempiti a sinistra).

Dimensioni del campo

w

Una stringa numerica che specifica la lunghezza minima del campo. Il campo sarà allineato a destra a meno di non avere impostato il flag -. Il valore di default è 0 (zero).

Precisione a sinistra

#n

Sono attesi un numero massimo di (n) numeri a sinistra del carattere decimale (es. il punto decimale). Solitamente si utilizza per mantenere allineato l'output nella medesima colonna, utilizzando il carattere di riempimento, se il numero delle cifre è inferiore a n. Se il numero delle cifre è superiore a n, questa specifica viene ignorata.

Se il raggruppamento delle cifre non è soppresso tramite ^, saranno inseriti i separatori di raggruppamento prima dei caratteri di riempimento (se presenti). I separatori di gruppo non saranno applicati ai caratteri di riempimento, anche se il carattere di riempimento è un numero.

Per garantire l'allineamento, ogni carattere che, nella stringa formattata, appare prima o dopo il numero, tipo il simbolo della moneta o il segno, viene riempito con gli spazi necessari affinché la corrispondente stringa risultante da un valore positivo o negativo abbia la medesima lunghezza.

Precisione di destra

.p

Un punto seguito da un numero di cifre (p) dopo il carattere decimale. Se il valore di p è 0 (zero), il carattere decimale e le cifre alla sua destra saranno omesse. Se non vi è indicazione della precisione a destra, il default sarà preso della impostazioni locali. L'importo sarà arrontondato alle cifre decimali richieste prima di essere formattato.

Caratteri di conversione

i

Il numero sarà formattato in base alle impostazioni internazionali locali (es. le impostazioni locali USA: USD 1,234.56).

n

Il numero sarà formattato in base alle locali impostazioni nazionali di moneta (es. per de_DE: DM1.234,56).

%

Restituisce il carattere %.

Nota: La categoria LC_MONETARY delle impostazioni locali influisce sul comportamento di questa funzione. Utilizzare setlocale() per impostare il default appropriato prima di utilizzare questa funzione.
I caratteri prima e dopo la stringa di formattazione saranno restituiti immutati.

Example #1 Esempio di uso di money_format()

Per illustrare il funzionamento della funzione utilizzeremo diversi formati di impostazioni locali.

<?php

$number 
1234.56;

// stampa nel formato internazionale per l'impostazione  en_US 
setlocale(LC_MONETARY'en_US');
echo 
money_format('%i'$number) . "\n";  
// USD 1,234.56

// Fromato italiano con 2 cifre decimali`
setlocale(LC_MONETARY'it_IT');
echo 
money_format('%.2n'$number) . "\n";
// L. 1.234,56

// Numeri negativi
$number = -1234.5672;

// Formato nazionale US, Utilizzo di () per i numeri negativi
// e 10 cifre di precisione a sinistra
setlocale(LC_MONETARY'en_US');
echo 
money_format('%(#10n'$number) . "\n";
// ($        1,234.57)

// Simile al precente con 2 cifre di precisione a destra
// e '*' come carattere di riempimento
echo money_format('%=*(#10.2n'$number) . "\n";
// ($********1,234.57)
    
// Giustificazione a sinistra, con 14 posizioni di lunghezza, 8 cifre di 
// precisione a sinistra, 2 di precisione a destra, senza carattere di raggruppamento
// e utilizzando l'impostazione locale de_DE.
setlocale(LC_MONETARY'de_DE');
echo 
money_format('%=*^-14#8.2i'1234.56) . "\n";
// DEM 1234,56****

// Qualche carattere prima e dopo la specifica di formattazione
setlocale(LC_MONETARY'en_GB');
$fmt 'The final value is %i (after a 10%% discount)';
echo 
money_format($fmt1234.56) . "\n";
// The final value is  GBP 1,234.56 (after a 10% discount)

?>

Vedere anche setlocale(), number_format(),sprintf(), printf() e sscanf().



nl_langinfo> <metaphone
Last updated: Fri, 18 Jul 2008
 
add a note add a note User Contributed Notes
money_format
chris () xeneco co-uk
18-Aug-2008 04: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 02: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 06: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 11: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 01: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 04: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 05: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 04: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

nl_langinfo> <metaphone
Last updated: Fri, 18 Jul 2008
 
 
show source | credits | sitemap | contact | advertising | mirror sites