XSLT的xsl:decimal-format怎么定义数字格式化规则

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 影响：

TabTab AI

首个全链路 Data Agent，让数据搜集、处理到深度分析一步到位。

326

查看详情

• # 表示“可选数字位”，不补零（如 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."

基本上就这些。不需要写逻辑判断，也不用拼字符串，靠声明式配置就能覆盖多数本地化和业务格式需求。

以上就是XSLT的xsl:decimal-format怎么定义数字格式化规则的详细内容，更多请关注php中文网其它相关文章！