lang.FormatCurrency
返回数字的货币表示,货币与精度由参数指定,并按当前语言与地区进行本地化。
这一页解决什么问题
显示价格、会费、预算这类金额时,除了数字本身,还要有货币符号,而且不同地区把它放的位置不同:英语是 $512.50,德语是 512,50 $。lang.FormatCurrency 接受精度、货币代码与数值,按站点当前的语言与地区拼出结果。
什么时候用,什么时候别用
该用:
- 多语言站点显示金额,希望符号、位置、小数分隔符都跟着地区走;
- 需要指定货币代码(
USD、CNY、NOK…)而不是自己拼符号。
别用:
- 普通数字(不带货币)→ 用
lang.FormatNumber; - 格式必须固定、不能随语言变化 → 用
lang.FormatNumberCustom自己拼货币代码; - 会计记法 → 用
lang.FormatAccounting;注意实测在本页的输入下两者输出完全相同(见该页说明)。
用法
go-html-template
{{ 512.5032 | lang.FormatCurrency 2 "USD" }} → $512.50完整示例(实测)
layouts/_partials/price.htmlgo-html-template
[{{ 512.5032 | lang.FormatCurrency 2 "USD" }}]|[{{ 512.5032 | lang.FormatCurrency 2 "CNY" }}]Hugo 0.167.0 实测输出,locale = 'en-US'(或 'zh-CN')时:
[$512.50]|[CN¥512.50]locale = 'de-DE' 时,同一段模板输出:
[512,50 $]|[512,50 CN¥]你应当看到什么:货币符号从「前置」变成「后置」,小数分隔符从 . 变成 ,——两处都是地区差异,与货币代码本身无关。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点,Windows;只改 locale。
| 输入(精度 2) | en-US |
de-DE |
zh-CN |
|---|---|---|---|
512.5032 + USD |
$512.50 |
512,50 $ |
$512.50 |
512.5032 + EUR |
€512.50 |
512,50 € |
€512.50 |
512.5032 + CNY |
CN¥512.50 |
512,50 CN¥ |
CN¥512.50 |
-1234.5 + USD |
$-1,234.50 |
-1.234,50 $ |
—— |
返回类型是 string;不支持的地区如何回退,上游未说明。
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 模板里写死了 ¥,换成 USD 时还在显示人民币符号 |
货币符号由 CURRENCY 参数决定,不要自己拼 |
传货币代码(如 "CNY"、"USD"),符号由函数给出 |
| 没报错但结果不对 | 不同语言站点符号位置不同,被当成 bug | 这是地区差异(实测 de-DE 后置) |
接受差异,或改用 lang.FormatNumberCustom 固定拼法 |
| 没报错但结果不对 | 中文站点输出与英文相同 | 实测 zh-CN 与 en-US 的表现一致 |
想验证本地化是否生效,用 de-DE 对照 |
更多排查入口见故障排查。