format-number()是XSLT中格式化数字的函数,需传入数值、格式模板及可选语言环境名;模板用#占位、0补零、.和,依decimal-format定义、%转百分比、;分正负;多语言需预定义xsl:decimal-format。

format-number() 是 XSLT 里专门把数字转成格式化字符串的函数,核心就三件事:传数字、给模板、选语言环境(可选)。
基本用法:三个参数怎么填
语法是:format-number(数字, 格式模板, [小数格式名])
- 第一个参数必须是数值类型,比如
12345.678或 XPath 表达式如price/text();不是数字会返回 NaN - 第二个参数是字符串模板,决定怎么显示——比如
'#,##0.00'表示带千位分隔符、固定两位小数 - 第三个参数可选,对应
<decimal-format></decimal-format>中定义的名称,用于切换小数点/分组符习惯(比如德语用逗号当小数点)
格式模板里那些符号什么意思
模板字符串由特殊字符组成,常见有:
-
#:占位数字,不显示无意义的零。例如format-number(5, '#.##')→"5",format-number(5.1, '#.##')→"5.1" -
0:强制补零。例如'00.00'下,format-number(7.5, '00.00')→"07.50" -
.:小数点位置(按当前 decimal-format 定义,不一定是英文句点) -
,:千位分隔符位置(同样受 decimal-format 控制) -
%:乘以 100 并加百分号。例如format-number(0.123, '0.00%')→"12.30%" -
;:分隔正负格式。例如'#,##0.00;(#,##0.00)',负数会加括号
需要多语言支持?用 <decimal-format></decimal-format>
默认情况下,小数点是 .,千位符是 ,。如果要适配欧洲习惯(小数点用逗号、千位用点),得提前声明:
<decimal-format name="euro" decimal-separator="," grouping-separator="."></decimal-format>
然后在函数里引用:format-number(12345.67, '#,##0.00', 'euro') → "12.345,67"
注意:name 必须完全匹配,且 <decimal-format></decimal-format> 要放在 <stylesheet></stylesheet> 顶层,不能嵌套。
常见坑和提醒
- 模板里不能随便加文字(如
'¥#,##0.00'),XSLT 会原样输出 ¥,但不保证对齐或编码安全;货币符号建议用外部拼接 - 小数部分自动四舍五入,不是截断。例如
format-number(1.999, '0.00')→"2.00" - 整数部分绝不会被截掉,哪怕模板写成
'#.##',12345也会完整显示为"12345" - NaN 和 Infinity 需通过
<decimal-format></decimal-format>的infinity或nan属性自定义显示,否则默认输出 “Infinity” 或 “NaN”
基本上就这些。用熟了模板字符和 decimal-format 配合,数字显示就能稳又准。