XPath的format-number()函数是处理数字格式化需求的核心工具，常用于XSLT转换、XML数据提取等场景，能够根据指定的格式模式将数字转换为符合要求的字符串形式。
format-number()函数基本语法
format-number()函数的标准语法格式如下，包含三个参数，其中第三个参数为可选参数：
format-number(number, format-pattern, decimal-format?)
- number：需要被格式化的数字，可以是具体的数值，也可以是返回数字类型的XPath表达式。
- format-pattern：字符串类型的格式模式，用来定义数字的显示规则，是格式化的核心参数。
- decimal-format：可选参数，用来指定自定义的十进制格式，若不传递则使用默认的十进制格式。
格式模式中的常用符号说明
格式模式由多个特殊符号组成，不同的符号对应不同的格式化规则，常用的符号含义如下：
| 符号 | 含义 |
|---|---|
| 0 | 表示必须显示的数字位，若对应位置没有数字则补0 |
| # | 表示可选显示的数字位，若对应位置没有数字则不显示 |
| . | 小数点分隔符，默认是点号，也可通过decimal-format自定义 |
| , | 分组分隔符，默认是逗号，用来分隔千分位等，也可自定义 |
| % | 将数字乘以100后添加百分号显示 |
| ¤ | 货币符号占位符，会替换为对应的货币符号 |
常见使用场景示例
1. 保留指定小数位
如果需要将数字保留两位小数，不足两位补0，可以使用模式0.00，示例代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<result>
<!-- 格式化数字123.4为两位小数 -->
<xsl:value-of select="format-number(123.4, '0.00')"/>
<!-- 输出结果为123.40 -->
</result>
</xsl:template>
</xsl:stylesheet>
2. 添加千分位分隔符
对较大的数字添加千分位分隔符，同时保留两位小数的示例如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<result>
<!-- 格式化数字1234567.89，添加千分位，保留两位小数 -->
<xsl:value-of select="format-number(1234567.89, '#,##0.00')"/>
<!-- 输出结果为1,234,567.89 -->
</result>
</xsl:template>
</xsl:stylesheet>
3. 格式化百分比
将小数转换为百分比显示的示例如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<result>
<!-- 将0.1234转换为百分比，保留两位小数 -->
<xsl:value-of select="format-number(0.1234, '0.00%')"/>
<!-- 输出结果为12.34% -->
</result>
</xsl:template>
</xsl:stylesheet>
4. 自定义十进制格式
如果需要修改默认的小数点分隔符或者分组分隔符，可以通过第三个参数自定义十进制格式，示例如下：
<?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="custom" decimal-separator="," grouping-separator="."/>
<xsl:template match="/">
<result>
<!-- 使用自定义格式，小数点用逗号，千分位用点号 -->
<xsl:value-of select="format-number(1234567.89, '#,##0.00', 'custom')"/>
<!-- 输出结果为1.234.567,89 -->
</result>
</xsl:template>
</xsl:stylesheet>
注意事项
- 如果传入的number参数不是有效的数字，函数会返回空字符串或者NaN相关的提示，具体表现取决于XPath的处理器实现。
- 格式模式中0和#的区别在于，0会强制显示对应位置的数字，不足则补0，而#只会显示存在的数字，不会补位。
- 第三个参数decimal-format需要先通过
<xsl:decimal-format>标签定义，并且指定唯一的名称，才能在format-number()中引用。
XPathformat-number数字格式化XSLT修改时间：2026-06-20 23:42:23