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

12次阅读

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

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

xsl:decimal-format 是 XSLT 中专门用来定义数字格式化行为的顶层元素,它不直接输出内容,而是为 format-number() 函数提供 本地化 符号规则和显示偏好。

核心作用:统一控制小数点、分组符等符号

不同地区对数字写法习惯不同——比如德国用 , 当小数点、. 当千位分隔符,而英语国家相反。xsl:decimal-format 就是用来适配这些差异的。它通过属性指定各类符号,后续所有调用 format-number() 的地方都会按此规则解析格式字符串(如 '#,##0.00')。

  • decimal-separator:小数点字符,默认是 .
  • grouping-separator:千位 / 万位分隔符,默认是 ,
  • minus-sign:负号,默认是 -
  • NaNinfinity:分别定义非数字和无穷大的显示文本,默认为 "NaN""Infinity"
  • percentper-millezero-digitdigit 等也均可自定义,满足特殊排版或 编码 需求

定义方式:全局默认 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-separatorgrouping-separator,不是格式字符串里写的字符
  • 如果输入是 NaN 或 Infinity,会直接输出 NaNinfinity 属性指定的字符串,不走格式模式

常见实用场景举例

比如处理 金融 数据导出为德语报表:

  • 定义:<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."

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

星耀云
版权声明:本站原创文章,由 星耀云 2025-12-15发表,共计1519字。
转载说明:转载本网站任何内容,请按照转载方式正确书写本站原文地址。本站提供的一切软件、教程和内容信息仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。
text=ZqhQzanResources