lang

lang.FormatPercent

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

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

这一页解决什么问题

显示占比、增长率这类百分比数值,并让它符合站点语言的书写习惯:英语紧贴数字(512.50%),德语会留一个空格(512,50 %),小数分隔符也跟着地区变。

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

该用:

  • 已经持有「百分比数值」并要显示出来;
  • 需要按语言/地区调整分隔符与百分号位置。

别用:

  • 手上是 0 到 1 的比例、想显示成百分数 → 本函数不会乘以 100(实测 512.5032 得 512.50%),要自己先乘;
  • 普通数字 → 用 lang.FormatNumber;货币 → 用 lang.FormatCurrency。

用法

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

完整示例(实测)

layouts/_partials/percent.htmlgo-html-template
[{{ 512.5032 | lang.FormatPercent 2 }}]

Hugo 0.167.0 实测输出,locale = 'en-US'(或 'zh-CN')时:

[512.50%]

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

[512,50 %]

你应当看到什么:百分号前多了一个空格,小数点变成逗号——512.5032 没有被乘成 51250.32,说明本函数只负责排版,不负责换算。

返回值边界(实测)

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

输入 en-US de-DE zh-CN
512.5032,精度 2 512.50% 512,50 % 512.50%
0.5,精度 2 0.50%——不是 50% —— ——
0.5,精度 0 1%(四舍五入到整数) —— ——
mul 0.75 100,精度 0 75%(要显示成百分比就得自己先乘 100) —— ——
是否报错 否 否 否
返回类型 string string string

常见坑

类别 症状 真因 怎么修
没报错但结果不对 0.75 显示成 0.75% 而不是 75% 本函数不做 ×100 的换算(实测) 先乘 100:{{ mul 0.75 100 | lang.FormatPercent 0 }}
没报错但结果不对 德语站点百分号前多出空格 这是地区排版习惯(实测 512,50 %) 属预期行为;需要紧凑写法就自己拼字符串
没报错但结果不对 中文站点与英文一样 实测 zh-CN 与 en-US 输出相同 用 de-DE 验证本地化是否生效

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