怎么用PHP的money_format函数把金额格式化成带千分位的货币形式？

gitbox 2025-07-09

在PHP中，money_format 函数是一个常用的工具，用来将数字格式化为货币形式。它根据系统的区域设置（locale）来调整货币符号、分隔符以及小数位的显示方式。这个函数能够很方便地将数值格式化成带有千分位的货币形式。

使用 money_format 函数的基本语法

<span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span> ( </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$format</span></span><span> , </span><span><span class="hljs-keyword">float</span></span><span> </span><span><span class="hljs-variable">$number</span></span><span> )
</span></span>

$format：是一个格式化字符串，通常包含了货币符号（例如 $、€ 等）以及千分位符、十进制符等格式化字符。
$number：是需要格式化的数字。

1. 设置正确的区域（Locale）

在使用 money_format 函数之前，需要先设置正确的区域，以确保格式化输出符合你希望的货币格式。PHP 通过 setlocale 函数来设置区域。

<span><span><span class="hljs-title function_ invoke__">setlocale</span></span><span>(LC_MONETARY, </span><span><span class="hljs-string">'en_US.UTF-8'</span></span><span>);  </span><span><span class="hljs-comment">// 设置为美国英语区域，使用美元符号和千分位符</span></span><span>
</span></span>

在这行代码中，我们设置了区域为美国英语 en_US.UTF-8，这意味着所有与货币相关的格式都将采用美国的标准，包括美元符号 $、千分位符 , 和小数点 .。

2. 格式化金额

接下来，你可以使用 money_format 来格式化金额。例如，假设你要格式化一个数字为货币形式：

<span><span><span class="hljs-variable">$amount</span></span><span> = </span><span><span class="hljs-number">1234567.89</span></span><span>;
</span><span><span class="hljs-variable">$formattedAmount</span></span><span> = </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%.2n'</span></span><span>, </span><span><span class="hljs-variable">$amount</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$formattedAmount</span></span><span>;  </span><span><span class="hljs-comment">// 输出：$1,234,567.89</span></span><span>
</span></span>

这里的格式化字符串 '%.2n' 的意思是：

%.2：表示保留两位小数。
n：表示输出带有货币符号的数字，并且适应当前区域的设置。

3. 如何显示不同的货币符号

如果你想格式化成不同货币符号的金额（例如，欧元、英镑等），你只需要调整区域设置。例如：

<span><span><span class="hljs-title function_ invoke__">setlocale</span></span><span>(LC_MONETARY, </span><span><span class="hljs-string">'de_DE.UTF-8'</span></span><span>);  </span><span><span class="hljs-comment">// 设置为德国的区域，使用欧元符号</span></span><span>
</span><span><span class="hljs-variable">$formattedAmount</span></span><span> = </span><span><span class="hljs-title function_ invoke__">money_format</span></span><span>(</span><span><span class="hljs-string">'%.2n'</span></span><span>, </span><span><span class="hljs-variable">$amount</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$formattedAmount</span></span><span>;  </span><span><span class="hljs-comment">// 输出：1.234.567,89 €</span></span><span>
</span></span>

在德国的区域设置下，货币格式发生了变化，千分位符变成了 .，而小数点符号变成了 ,，货币符号则是欧元符号 €。

4. 注意事项

money_format 只能在支持该函数的操作系统中使用。通常，在类 Unix 系统（如 Linux 和 macOS）中，money_format 是可用的，但在 Windows 系统中可能不可用。如果你的开发环境是 Windows，可以考虑使用其他格式化方法，比如 number_format。
money_format 会根据当前区域的设置自动适配格式，所以在不同区域可能得到不同的格式化结果。

5. 使用 number_format 作为替代

如果你不需要依赖系统的区域设置，或者在不支持 money_format 的系统中工作，可以使用 PHP 的 number_format 函数来手动格式化金额并添加千分位符：

<span><span><span class="hljs-variable">$formattedAmount</span></span><span> = </span><span><span class="hljs-string">'$'</span></span><span> . </span><span><span class="hljs-title function_ invoke__">number_format</span></span><span>(</span><span><span class="hljs-variable">$amount</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>, </span><span><span class="hljs-string">'.'</span></span><span>, </span><span><span class="hljs-string">','</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$formattedAmount</span></span><span>;  </span><span><span class="hljs-comment">// 输出：$1,234,567.89</span></span><span>
</span></span>

number_format 函数提供了以下参数：

第一个参数：数字。
第二个参数：小数点后保留的位数。
第三个参数：小数点符号（通常是 .）。
第四个参数：千分位符号（通常是 ,）。

结论

PHP 的 money_format 函数是一个非常方便的工具，尤其在处理货币格式化时，它能够根据不同区域的设置自动调整格式，省去了许多手动处理的麻烦。然而，记得检查你所在的开发环境是否支持该函数，如果不支持，可以使用 number_format 来代替。