xsl:decimal-format 是 XSLT 中定义数字格式化规则的顶层元素,通过属性如 decimal-separator、grouping-separator 等统一控制 format-number() 的本地化显示行为,支持默认及具名格式,适配多语言数字习惯。

xsl:decimal-format 是 XSLT 中专门用来定义数字格式化行为的顶层元素,它不直接输出内容,而是为 format-number() 函数提供 本地化 符号规则和显示偏好。
核心作用:统一控制小数点、分组符等符号
不同地区对数字写法习惯不同——比如德国用 , 当小数点、. 当千位分隔符,而英语国家相反。xsl:decimal-format 就是用来适配这些差异的。它通过属性指定各类符号,后续所有调用 format-number() 的地方都会按此规则解析格式字符串(如 '#,##0.00')。
-
decimal-separator:小数点字符,默认是. -
grouping-separator:千位 / 万位分隔符,默认是, -
minus-sign:负号,默认是- -
NaN和infinity:分别定义非数字和无穷大的显示文本,默认为"NaN"和"Infinity" -
percent、per-mille、zero-digit、digit等也均可自定义,满足特殊排版或 编码 需求
定义方式:全局默认 or 命名格式
可以只定义一个默认格式(无 name 属性),也可以定义多个命名格式供按需调用。
- 全局默认:
<decimal-format decimal-separator="," grouping-separator="."></decimal-format>—— 所有未指定 name 的format-number()都会使用它 - 具名格式:
<decimal-format name="german" decimal-separator="," grouping-separator="."></decimal-format>—— 调用时写format-number(12345.67, '#,##0.00', 'german') - 注意:同一名称不能重复声明;若多次声明默认格式,所有属性(含默认值)必须完全一致,否则报错
配合 format-number() 使用的关键细节
格式字符串里的 # 和 0 含义不同,且受 decimal-format 影响:
-
#表示“可选数字位”,不补零(如format-number(5, '#.00')→"5.00";但format-number(5, '#.#')→"5") -
0表示“强制数字位”,不足则补零(format-number(5, '00.00')→"05.00") - 小数点和分组符实际显示什么,取决于
xsl:decimal-format中定义的decimal-separator和grouping-separator,不是格式字符串里写的字符 - 如果输入是 NaN 或 Infinity,会直接输出
NaN或infinity属性指定的字符串,不走格式模式
常见实用场景举例
比如处理 金融 数据导出为德语报表:
- 定义:
<decimal-format name="de" decimal-separator="," grouping-separator="." nan="n.v."></decimal-format> - 调用:
format-number(1234567.89, '#.##0,00', 'de')→"1.234.567,89" - 遇到空值:
format-number($price, '#.##0,00', 'de')中若$price为空或非法,结果就是"n.v."
基本上就这些。不需要写逻辑判断,也不用拼字符串,靠声明式配置就能覆盖多数本地化和业务格式需求。