= 4.3.0, PHP 5, PHP 7)money_format — 將數(shù)字格式化成貨幣字符串說明money_format(string $format, float $number): stringmoney_format() 返回格式化好的 numbe">
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
money_format — 將數(shù)字格式化成貨幣字符串
$format
, float $number
): string
money_format() 返回格式化好的
number
版本。
此函數(shù)包裝了 C 函數(shù)庫中的 strfmon(),不同之處是:此實現(xiàn)每次只能轉(zhuǎn)化一個數(shù)字。
format
格式字符串由以下幾部分組成:
單個 %
字符
可選的標記(flags)
可選的字段寬度
可選的,左側(cè)精度
可選的,右側(cè)精度
必選的,單個轉(zhuǎn)化字符
可選多個標記,分別是:
=
f
字符:=
,并緊跟一個字符(單字節(jié)) f,用于數(shù)字填充。默認的填充字符是空格。
^
禁用分組字符(比如金額中的逗號。在本地區(qū)域設(shè)置 locale 中定義)。
+
or (
正負數(shù)字的格式。使用 +
,將使用區(qū)域設(shè)置(locale)中相當于 +
和 -
的符號。
如果使用 (
,負數(shù)將被圓括號圍繞。不設(shè)置的話,默認為
+
。
!
不輸出貨幣符號(比如 ¥)。
-
有這個符號的時候,將使字段左對齊(填充到右邊),默認是相反的,是右對齊的(填充到左邊)。
十進制數(shù)值字符串的寬度。字段將右對齊,除非使用了 -
標記。默認值 0。
#
n小數(shù)字符(比如小數(shù)點)前的最大位數(shù) (n)。 常用于同一列中的格式對齊。 如果位數(shù)小于 n 則使用填充字符填滿。 如果實際位數(shù)大于 n,此設(shè)置將被忽略。
如果沒用 ^
標識禁用分組,分組分隔符會在添加填充字符之前插入(如果有的話)。
分組分隔符不會應(yīng)用到填充字符里,哪怕填充字符是個數(shù)字。
為了保證對齊,出現(xiàn)在之前或者之后的字符,都會填充必要的空格,保證正負情況下長度都一樣。
.
p小數(shù)點后的一段數(shù)字 (p)。 如果 p 的值是 0(零),小數(shù)點右側(cè)的數(shù)值將被刪除。 如果不使用這個標記,默認展現(xiàn)取決于當前的區(qū)域設(shè)置。 小數(shù)點后指定位數(shù)的數(shù)字,四舍五入格式化。
i
根據(jù)國際化區(qū)域設(shè)置中的貨幣格式,格式化數(shù)值。(比如,locale 是 USA:USD 1,234.56)。
n
根據(jù)國際化區(qū)域設(shè)置中國家的貨幣格式,格式化數(shù)值。(比如,locale 是 de_DE:EU1.234,56)。
%
返回字符 %
。
number
需要格式化的數(shù)字。
返回格式化后的字符。格式字符串前后的字符將原封不動返回。
傳入的 number
如果不是數(shù)字,將返回 null
并且產(chǎn)生
E_WARNING
。
注意:
具有 strfmon 的系統(tǒng)才有 money_format() 函數(shù)。 例如 Windows 不具備,所以 Windows 系統(tǒng)上 money_format() 未定義。
注意:
locale 設(shè)置中,
LC_MONETARY
會影響此函數(shù)的行為。 在使用函數(shù)前,首先要用 setlocale() 來設(shè)置合適的區(qū)域設(shè)置(locale)。
示例 #1 money_format() 例子
使用不同的 locale 和格式字符串,來說明此函數(shù)的用法。
<?php
$number = 1234.56;
// 讓我們打印 en_US locale 的國際化格式
setlocale(LC_MONETARY, 'en_US');
echo money_format('%i', $number) . "\n";
// USD 1,234.56
// 意大利國家的格式,帶兩位浮點小數(shù)`
setlocale(LC_MONETARY, 'it_IT');
echo money_format('%.2n', $number) . "\n";
// Eu 1.234,56
// 負數(shù)的使用
$number = -1234.5672;
// 美國國家的格式,使用圓括號 () 標記負數(shù)。
// 左側(cè)精度使用十位
setlocale(LC_MONETARY, 'en_US');
echo money_format('%(#10n', $number) . "\n";
// ($ 1,234.57)
// 相似的格式,添加了右側(cè)兩位小數(shù)點的精度,同時用 * 來填充
echo money_format('%=*(#10.2n', $number) . "\n";
// ($********1,234.57)
// 讓我們左對齊,14位寬,左側(cè)八位,右側(cè)兩位,不帶分組字符
// 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 = 'The final value is %i (after a 10%% discount)';
echo money_format($fmt, 1234.56) . "\n";
// The final value is GBP 1,234.56 (after a 10% discount)
?>