文档章节
语言函数
使用这些函数让站点满足语言与地区方面的要求。
这一页解决什么问题
这一章收录两类函数:一类按当前语言与地区格式化数字(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 {})。
建议阅读顺序
- 数字本地化:lang.FormatNumber、lang.FormatCurrency、lang.FormatPercent、lang.FormatAccounting;
- 固定格式:lang.FormatNumberCustom;
- 多语言内容:lang.Translate(含复数与翻译表查找规则)、lang.Merge。
这些函数的实测结果都依赖站点的 locale(或语言配置),看任何一页的示例时请先注意它的测量条件。
本章内容
- lang.FormatAccounting 以会计记法返回数字的货币表示,货币与精度由参数指定,并按当前语言与地区进行本地化。 (今天)
- lang.FormatCurrency 返回数字的货币表示,货币与精度由参数指定,并按当前语言与地区进行本地化。 (今天)
- lang.FormatNumber 返回数字按给定精度、面向当前语言与地区进行本地化后的数字表示。 (今天)
- lang.FormatNumberCustom 使用负数、小数点与分组选项,返回数字按给定精度的数字表示。 (今天)
- lang.FormatPercent 返回数字按给定精度、面向当前语言与地区进行本地化后的百分比表示。 (今天)
- lang.Merge 返回给定页面集合的副本,其中缺失的译文页面由另一个页面集合补齐。 (今天)
- lang.Translate 使用 i18n 目录中的翻译表返回翻译后的字符串。 (今天)