文档章节

语言函数

使用这些函数让站点满足语言与地区方面的要求。

这一页解决什么问题

这一章收录两类函数:一类按当前语言与地区格式化数字(FormatNumber、FormatCurrency、FormatPercent、FormatAccounting,以及不受地区影响的 FormatNumberCustom);另一类服务于多语言内容(Translate 取翻译表中的文案、Merge 用其它语言补齐缺失译文)。上游这些页原来只有签名和几行说明,本站为每页补上了「什么时候用 / 什么时候别用」「可直接粘贴的实测示例」与「返回值边界」。

读完本章你应该能够

  • 分清「跟随地区」与「固定格式」:lang.FormatNumber 等会随 locale 变化(实测 512.5032 在 en-US 下是 512.50、在 de-DE 下是 512,50),而 lang.FormatNumberCustom 完全无视 locale;
  • 知道 lang.FormatPercent 不会把 0.5 变成 50%——输入多少就显示多少;
  • 会用 lang.Translate 的复数形式与 count 上下文,并知道缺失 key 会静默返回空字符串、找不到译文时会回退到默认语言(实测);
  • 知道 lang.Merge 只支持页面集合,用在 dict 上会让构建失败(实测报错 language merge not supported for map[string]interface {})。

建议阅读顺序

  1. 数字本地化:lang.FormatNumber、lang.FormatCurrency、lang.FormatPercent、lang.FormatAccounting;
  2. 固定格式:lang.FormatNumberCustom;
  3. 多语言内容:lang.Translate(含复数与翻译表查找规则)、lang.Merge。

这些函数的实测结果都依赖站点的 locale(或语言配置),看任何一页的示例时请先注意它的测量条件。

本章内容

  • lang.FormatAccounting 以会计记法返回数字的货币表示,货币与精度由参数指定,并按当前语言与地区进行本地化。 (今天)
  • lang.FormatCurrency 返回数字的货币表示,货币与精度由参数指定,并按当前语言与地区进行本地化。 (今天)
  • lang.FormatNumber 返回数字按给定精度、面向当前语言与地区进行本地化后的数字表示。 (今天)
  • lang.FormatNumberCustom 使用负数、小数点与分组选项,返回数字按给定精度的数字表示。 (今天)
  • lang.FormatPercent 返回数字按给定精度、面向当前语言与地区进行本地化后的百分比表示。 (今天)
  • lang.Merge 返回给定页面集合的副本,其中缺失的译文页面由另一个页面集合补齐。 (今天)
  • lang.Translate 使用 i18n 目录中的翻译表返回翻译后的字符串。 (今天)