nl_langinfo

metaphone

[edit] Last updated: Fri, 25 May 2012

money_format

(PHP 4 >= 4.3.0, PHP 5)

money_format — Форматирует число как денежную величину

Описание

string money_format ( string $format , float $number )

money_format() форматирует число number как денежную величину. Эта функция вызывает функцию strfmon() языка C, но позволяет преобразовать только одно число за один вызов.

Список параметров

format

Описание формата состоит из:

символа %
необязательных флагов
необязательной ширины поля
необязательной точности до запятой
необязательной точности после запятой
обязательного описателя преобразования

Флаги

Могут быть использованы следующие флаги:

=f: Символ =, за которым следует еще один символ f, задает символ заполнения. По умолчанию пробел.
^: Отключает группировку символов (определяемую текущей локалью).
+ или (: Задает способ форматирования положительных и отрицательных значений. При использовании + будут использоваться аналоги символов + и - из текущей локали. Если указана (, отрицательные числа будут заключены в скобки. По умолчанию +.
!: Подавляет вывод символа валюты.
-: Если этот флаг задан, поля будут выравнены влево (с отбивкой вправо), вместо используемого по умолчанию выравнивания вправо (с отбивкой влево).

Ширина поля

w: Строка из десятичных цифр, задающая минимальную ширину поля. Поле будет выравнено вправо, если не указан флаг -. Значение по умолчанию - 0 (ноль).

Точность до запятой

#n

Максимальное количество цифр (n), которое ожидается до запятой. Это обычно используется при выводе значений одно под другим, чтобы десятичные точки располагались в одной колонке, при этом используется символ заполнения, если число цифр меньше n. Если число цифр больше n, этот параметр игнорируется.

Если группировка не была отключена флагом ^, разделители групп будут вставлены перед добавлением символов заполнения. Разделители групп не вставляются между символами заполнения, даже если заполнитель - цифра.

Для обеспечения выравнивания, все символы, выводимые до или после числа, такие как сивол валюты или знак, будут дополнены пробелами до одинаковой ширины.

Точность после запятой

.p: Точка, за которой следует число знаков (p), выводимых после запятой. Если значение p равно нулю, десятичная точка и цифры после нее не будут выводиться. Если этот параметр отсутствует, число знаков после запятой определяется текущей локалью. Перед форматированием число округляется до указанного количества знаков.

Описатель преобразования

i: Используется международный денежный формат из текущей локали (например, для американской локали: USD 1,234.56).
n: Используется национальный денежный формат из текущей локали (например, для локали de_DE: EU1.234,56).
%: Вставляет символ %.

number

Форматируемое число.

Возвращаемые значения

Возвращает отформатированную строку. Символы перед и после описания формата возвращаются без изменений. Если number не является числом, то будет возвращен NULL и вызвана ошибка уровня E_WARNING.

Примечания

Замечание:
Функция money_format() определена только если в системе присутствует функция strfmon. Например, в Windows она отсутствует, поэтому money_format() не определена в Windows.

Замечание:
На работу этой функции влияет установка категории LC_MONETARY текущей локали. Перед использованием этой функции установите нужную локаль с помощью setlocale().

Примеры

Пример #1 Пример использования money_format()

Проиллюстрируем применение этой функции для различных локалей и разных описаний формата.


<?php

$number = 1234.56;

// международный формат в локали en_US
setlocale(LC_MONETARY, 'en_US');
echo money_format('%i', $number) . "\n";
// USD 1,234.56

// Итальянский национальный формат с 2 знаками после запятой
setlocale(LC_MONETARY, 'it_IT');
echo money_format('%.2n', $number) . "\n";
// Eu 1.234,56

// Использование отрицательных чисел
$number = -1234.5672;

// национальный формат США, с использованием скобок для
// отрицательных чисел и 10 знаков до запятой
setlocale(LC_MONETARY, 'en_US');
echo money_format('%(#10n', $number) . "\n";
// ($        1,234.57)

// подобно предыдущему, но с добавлением 2 знаков после запятой
// и '*' в качестве символа заполнения
echo money_format('%=*(#10.2n', $number) . "\n";
// ($********1,234.57)
    
// Выравнивание влево, ширина 14 знаков, 8 знаков до запятой,
// 2 знака после запятой, без разбиения на группы
// с использованием  международного формата в локали de_DE.
setlocale(LC_MONETARY, 'de_DE');
echo money_format('%=*^-14#8.2i', 1234.56) . "\n";
// Eu 1234,56****

// А теперь добавим текст перед и после описанием формата
setlocale(LC_MONETARY, 'en_GB');
$fmt = 'Итоговая сумма: %i (после 10%% скидки)';
echo money_format($fmt, 1234.56) . "\n";
// Итоговая сумма:  GBP 1,234.56 (после 10% скидки)

?>

Смотрите также

setlocale() - Устанавливает настройки локали
sscanf() - Разбирает строку в соответствии с заданным форматом
sprintf() - Возвращает отформатированную строку
printf() - Выводит отформатированную строку
number_format() - Форматирует число с разделением групп

nl_langinfo

metaphone

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes money_format

phpdeveloperbalaji at gmail dot com 28-Sep-2011 01:04


Hi,





For South Asian Currencies, this function could be a handy one.





It will handle negative as well as float(Paise).





<?php


function my_money_format($number)


{


    if(strstr($number,"-"))


    {


        $number = str_replace("-","",$number);


        $negative = "-";


    }


    


    $split_number = @explode(".",$number);


    


    $rupee = $split_number[0];


    $paise = @$split_number[1];


    


    if(@strlen($rupee)>3)


    {


        $hundreds = substr($rupee,strlen($rupee)-3);


        $thousands_in_reverse = strrev(substr($rupee,0,strlen($rupee)-3));


        for($i=0; $i<(strlen($thousands_in_reverse)); $i=$i+2)


        {


            $thousands .= $thousands_in_reverse[$i].$thousands_in_reverse[$i+1].",";


        }


        $thousands = strrev(trim($thousands,","));


        $formatted_rupee = $thousands.",".$hundreds;


        


    }


    else


    {


        $formatted_rupee = $rupee;


    }


    


    if((int)$paise>0)


    {


        $formatted_paise = ".".substr($paise,0,2);


    }


    


    return $negative.$formatted_rupee.$formatted_paise;





}


?>





Thanks,

andrey.dobrozhanskiy [-a-t-] gmail com 07-Jul-2010 09:43


This function divides integer value by commas. F.e.





<?php


echo formatMoney(1050); # 1,050


echo formatMoney(1321435.4, true); # 1,321,435.40


echo formatMoney(10059240.42941, true); # 10,059,240.43


echo formatMoney(13245); # 13,245





function formatMoney($number, $fractional=false) {


    if ($fractional) {


        $number = sprintf('%.2f', $number);


    }


    while (true) { 


        $replaced = preg_replace('/(-?\d+)(\d\d\d)/', '$1,$2', $number);


        if ($replaced != $number) {


            $number = $replaced;


        } else {


            break;


        }


    }


    return $number;


}


?>

Rafael M. Salvioni 19-Feb-2009 12:20


This is a some function posted before, however various bugs were corrected.





Thank you to Stuart Roe by reporting the bug on printing signals.





<?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.


*/


function money_format($format, $number)


{


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


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


    if (setlocale(LC_MONETARY, 0) == 'C') {


        setlocale(LC_MONETARY, '');


    }


    $locale = localeconv();


    preg_match_all($regex, $format, $matches, PREG_SET_ORDER);


    foreach ($matches as $fmatch) {


        $value = floatval($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 ($value < 0) {


            $positive = false;


            $value  *= -1;


        }


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





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





        $signal = $positive ? $locale['positive_sign'] : $locale['negative_sign'];


        switch (true) {


            case $locale["{$letter}_sign_posn"] == 1 && $flags['usesignal'] == '+':


                $prefix = $signal;


                break;


            case $locale["{$letter}_sign_posn"] == 2 && $flags['usesignal'] == '+':


                $suffix = $signal;


                break;


            case $locale["{$letter}_sign_posn"] == 3 && $flags['usesignal'] == '+':


                $cprefix = $signal;


                break;


            case $locale["{$letter}_sign_posn"] == 4 && $flags['usesignal'] == '+':


                $csuffix = $signal;


                break;


            case $flags['usesignal'] == '(':


            case $locale["{$letter}_sign_posn"] == 0:


                $prefix = '(';


                $suffix = ')';


                break;


        }


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


            $currency = $cprefix .


                        ($conversion == 'i' ? $locale['int_curr_symbol'] : $locale['currency_symbol']) .


                        $csuffix;


        } else {


            $currency = '';


        }


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





        $value = number_format($value, $right, $locale['mon_decimal_point'],


                 $flags['nogroup'] ? '' : $locale['mon_thousands_sep']);


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





        $n = strlen($prefix) + strlen($currency) + strlen($value[0]);


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


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


        }


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


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


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


        } else {


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


        }


        if ($width > 0) {


            $value = str_pad($value, $width, $flags['fillchar'], $flags['isleft'] ?


                     STR_PAD_RIGHT : STR_PAD_LEFT);


        }





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


    }


    return $format;


}





?>

jeremy 30-Sep-2008 10: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.

swapnet 22-Jul-2008 08: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.

scot from ezyauctionz.co.nz 06-Oct-2007 03: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.





<?php


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


// 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.

richard dot selby at uk dot clara dot net 17-Feb-2006 07: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.

add a note