XSLT的decimal-format如何控制数字格式？

XSLT作为XML转换的核心技术，在处理数据输出时经常需要对数字进行格式化调整，decimal-format元素就是实现这一需求的关键配置项，它可以为format-number函数提供自定义的数字格式规则，覆盖默认的数字输出样式。

decimal-format的基本语法

decimal-format属于XSLT的顶层元素，需要定义在<xsl:stylesheet>根元素下，它的核心作用是为数字格式化定义一组字符规则，这些规则会被后续的<xsl:decimal-format>关联的format-number函数使用。基本语法结构如下：

<xsl:decimal-format
  name="格式名称"
  其他属性配置
/>

其中name属性是可选的，如果不指定name，那么该decimal-format会成为默认的数字格式规则，所有未指定格式名称的format-number函数都会使用这套规则。如果指定了name，那么在使用format-number时需要显式引用该名称。

decimal-format的常用属性

decimal-format提供了多个属性来定制数字格式，常用的属性及作用如下：

decimal-format的使用示例

示例1：自定义默认数字格式

下面的示例定义了一个默认的decimal-format，将小数点设置为逗号，千位分隔符设置为点，然后格式化一个数字：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <!-- 定义默认decimal-format -->
  <xsl:decimal-format
    decimal-separator=","
    grouping-separator="."
  />

  <xsl:template match="/">
    <result>
      <!-- 格式化数字1234567.89 -->
      <num>
        <xsl:value-of select="format-number(1234567.89, '#,##0.00')"/>
      </num>
    </result>
  </xsl:template>
</xsl:stylesheet>

上述代码执行后，输出的数字格式为1.234.567,89，符合我们自定义的小数点和千位分隔符规则。

示例2：定义带名称的decimal-format处理货币

如果需要同时处理多种数字格式，比如普通数字和货币数字，可以定义多个带名称的decimal-format：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <!-- 普通数字格式 -->
  <xsl:decimal-format name="normal"/>

  <!-- 人民币格式，添加¥符号，保留两位小数 -->
  <xsl:decimal-format name="cny" decimal-separator="." grouping-separator=","/>

  <xsl:template match="/">
    <result>
      <normal_num>
        <xsl:value-of select="format-number(9876.5, '#,##0.00', 'normal')"/>
      </normal_num>
      <cny_num>
        ¥<xsl:value-of select="format-number(9876.5, '#,##0.00', 'cny')"/>
      </cny_num>
    </result>
  </xsl:template>
</xsl:stylesheet>

执行后普通数字输出为9,876.50，货币数字输出为¥9,876.50，实现了不同场景的数字格式区分。

示例3：处理特殊数字情况

decimal-format还可以自定义无穷大、非数字等特殊情况的显示内容：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:decimal-format
    name="special"
    infinity="无穷大"
    NaN="非数字"
    minus-sign="负"
  />

  <xsl:template match="/">
    <result>
      <infinity_val>
        <xsl:value-of select="format-number(1 div 0, '0', 'special')"/>
      </infinity_val>
      <nan_val>
        <xsl:value-of select="format-number('abc', '0', 'special')"/>
      </nan_val>
      <negative_val>
        <xsl:value-of select="format-number(-123.45, '0.00', 'special')"/>
      </negative_val>
    </result>
  </xsl:template>
</xsl:stylesheet>

上述代码执行后，无穷大输出为无穷大，非数字输出为非数字，负数输出为-123.45，符合我们自定义的特殊字符规则。

注意事项

• decimal-format的name属性值需要唯一，不能重复定义相同名称的格式规则。
• format-number函数的第二个参数是格式模式，其中#表示可选数字位，0表示强制数字位，需要和decimal-format的属性配合使用。
• 如果同时定义了默认decimal-format和带名称的decimal-format，未指定格式名称的format-number会优先使用默认规则。
• decimal-format的属性值只能是单个字符，不能设置为多个字符的组合。

XSLTdecimal_format数字格式化XML转换修改时间：2026-07-18 09:15:38