lang

lang.FormatNumber

返回数字按给定精度、面向当前语言与地区进行本地化后的数字表示。

签名
lang.FormatNumber PRECISION NUMBER
返回类型
string

这一页解决什么问题

页面上要显示带千分位和小数位的数字(阅读量、金额数量、统计数字),而且不同语言站点要显示成各自习惯的样子:英语用 1,234,567.89,德语用 1.234.567,89——同一个数字,小数点与分组符正好相反。lang.FormatNumber 按站点当前的语言与地区自动选择,不用为每种语言写一套模板。

什么时候用,什么时候别用

该用:

  • 多语言站点里显示数字,希望跟随语言/地区习惯;
  • 需要固定小数位(精度参数直接指定)。

别用:

用法

go-html-template
{{ 512.5032 | lang.FormatNumber 2 }} → 512.50

完整示例(实测)

layouts/_partials/stats.htmlgo-html-template
[{{ 512.5032 | lang.FormatNumber 2 }}]|[{{ 1234567.891 | lang.FormatNumber 2 }}]

Hugo 0.167.0 实测输出,locale = 'en-US' 时:

[512.50]|[1,234,567.89]

locale = 'de-DE' 时,同一段模板输出:

[512,50]|[1.234.567,89]

你应当看到什么:数字本身没变,只是小数点与分组符互换了,精度都保持两位。locale = 'zh-CN' 实测与 en-US 相同(512.50 / 1,234,567.89)。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点,Windows;只改 locale。

输入 en-US de-DE zh-CN
512.5032,精度 2 512.50 512,50 512.50
1234567.891,精度 2 1,234,567.89 1.234.567,89 1,234,567.89
是否报错 否 否 否
返回类型 string string string

精度参数决定小数位数(512.5032 精度 2 → 四舍五入到两位)。本函数对无法识别的地区会回退,但具体回退目标上游未说明。

常见坑

类别 症状 真因 怎么修复
没报错但结果不对 不同语言站点显示格式不同,被当成 bug 这正是本函数的用途:格式跟随 locale 需要统一格式就用 lang.FormatNumberCustom
没报错但结果不对 数字与预期不符(多/少千分位) 精度参数只控制小数位,分组按地区规则 对照本页实测表确认目标地区的写法
没报错但结果不对 中英文站点格式一样,以为没生效 实测 zh-CN 与 en-US 的输出相同 用 de-DE 之类差异明显的地区验证是否生效

更多排查入口见故障排查。