PHP money_format() 函數

PHP String 參考手冊 PHP String 參考手冊

實例

en_US 國際格式：

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"en_US");
echo money_format("The price is %i", $number);
?>

上面的代碼將輸出：

The price is USD 1,234.56

定義和用法

money_format() 函數返回格式化為貨幣字串的字串。

該函數在主字串的百分號（%）位置插入一個格式化的數字。

注釋：money_format() 函數無法在 Windows 平臺上工作。

提示：該函數經常與 setlocale() 函數一起使用。

提示：如需查看所有可用的語言代碼，請訪問我們的語言代碼參考手冊。

語法

money_format(string,number)

參數 描述
string 必需。規定要格式化的字串及如何格式化字串中的變數。

可能的格式值：

填充和標誌：

  • =f - 規定字元（f）用作填充（例如：%=t 使用 "t" 作為填充）。默認使用空格作為填充。
  • ^ - 移除分組字元的使用。
  • + 或 ( - 規定如何顯示正數和負數。如果使用 "+"，則使用本地設置的 + 和 -（通常在負數前加符號，贈書前不加任何符號）。如果使用 "("，負數被包含在括弧內部。默認是使用 "+"。
  • ! - 停止在輸出字串中使用貨幣符號。
  • - 如果使用 "-"，所有字段左對齊。默認是右對齊。

字段寬度：

  • x - 規定字段的最小寬度（x）。默認是 0。
  • #x - 規定小數點左邊數字的最大位數（x）。用於保持格式化輸出在同一列對齊。如果數字位數大於 x，本規定將被忽略。
  • .x - 規定小數點右邊數字的最大位數（x）。如果 x 是 0，小數點及其右邊的數字將不會顯示。默認使用本地設置。

轉換字元：

  • i - 數字被格式化為國際貨幣格式。
  • n - 數字被格式化為國家貨幣格式。
  • % - 返回 % 字元。

注釋：如果使用多個上述的格式值，它們必須按照上面的順序進行使用，不能打亂。

注釋：該函數受本地設置的影響。
number 必需。被插入到格式化字串中 % 符號位置的數字。

技術細節

返回值： 返回已格式化的字串。格式化字串前面和後面的字元將保持不變返回。非數值數字會返回 NULL 並產生 E_WARNING。
PHP 版本： 4.3.0+

更多實例

實例 1

帶 2 個小數的國際格式（德國）：

<?php
$number = 1234.56;
setlocale(LC_MONETARY,"de_DE");
echo money_format("%.2n", $number);
?>

上面的代碼將輸出：

1 234,56 EUR


實例 2

負數，帶有 () 指示負數的 US 國際格式，右側精度為 2，"*" 為填充字元：

<?php
$number = -1234.5672;
echo money_format("%=*(#10.2n",$number);
?>

上面的代碼將輸出：

(******1234.57)


PHP String 參考手冊 PHP String 參考手冊