format-number()函数可按指定格式将数字转为字符串，支持千位分隔、小数位控制、百分比、货币符号及多语言环境。通过pattern定义格式，如#,##0.00保留两位小数并千位分隔，0强制显示零，%转为百分比，¤表示货币符号，分号区分正负数格式。结合xsl:decimal-format可定义小数点、分组符、NaN等本地化规则，实现国际化显示，如德语用逗号作小数点。需注意#不显示无意义零，0强制补零，避免格式错误；特殊值NaN和Infinity应通过decimal-format自定义提示；复杂模式应逐步调试；海量数据时简单格式化可考虑替代函数提升性能。
在XPath里，
format-number()
函数简直是把数字按你心意格式化的魔法棒。它能让你把一个原始的数字，根据你给定的格式模板和可选的语言环境设置，转换成一个带有特定显示效果的字符串。想象一下，你想把“12345.678”变成“$12,345.68”或者“12.345,68 €”，这个函数就是你的得力助手。
解决方案
format-number()
函数的基本语法是这样的：
format-number(number, pattern, [decimal-format-name])
-
number
：这是你想要格式化的那个数字，可以是数值字面量，也可以是计算结果。
-
pattern
：这是最关键的部分，一个字符串，定义了数字应该如何显示。它由一系列特殊字符组成，比如
#
、
0
、
,
、
.
等等，这些字符决定了数字的位数、小数位、千位分隔符、货币符号等。
-
decimal-format-name
：这是一个可选参数。当你的格式需求超越了简单的模式字符串，比如需要针对不同语言环境（如德语用逗号做小数分隔符）定义一套完整的数字格式规则时，你可以用
xsl:decimal-format
元素在XSLT中预先定义好这些规则，然后在这里引用它的名字。这样就能确保你的数字格式在全球化应用中表现一致。
举个最简单的例子：
假设你想把数字
12345.678
格式化成保留两位小数，并且有千位分隔符的样子。
format-number(12345.678, '#,##0.00')
会得到
"12,345.68"
。 注意这里自动进行了四舍五入。
如果只是想保留整数，没有小数：
format-number(12345.678, '#')
会得到
"12346"
。
想展示百分比？
format-number(0.123, '0.0%')
会得到
"12.3%"
。函数会自动将数字乘以100。
格式模式（Pattern）到底怎么写？核心符号解析
谈到
format-number()
，最让人头疼的可能就是那个
pattern
字符串了。我刚开始接触的时候，也觉得这堆符号简直是天书，但用多了，你会发现它们其实非常有逻辑。理解这些核心符号，你就掌握了格式化的精髓。
-
#
(井号)：这是一个数字占位符。它表示如果这个位置有数字就显示，如果没有（比如在数字左侧的零，或者小数位末尾的零），就省略不显示。比如说，
#.##
对于
12.3
会显示
12.3
，对于
12.00
会显示
12
。
-
0
(零)：这也是一个数字占位符，但它是个“强制”占位符。如果这个位置没有数字，它会强制显示一个零。这在控制小数位数或者确保数字有最小宽度时非常有用。比如，
000.00
对于
1.2
会显示
001.20
。
-
.
(点)：这是小数分隔符。它定义了整数部分和小数部分的分界线。
-
,
(逗号)：这是分组分隔符，通常用于千位分隔。它会根据你的区域设置（或
decimal-format
定义）来插入。例如，
#,##0.00
就是典型的英文千位分隔符。
-
-
(减号)：表示负数符号的位置。通常放在数字前面。
-
%
(百分号)：表示将数字乘以100并显示为百分比。
-
¤
(货币符号)：表示货币符号的位置。这通常与
xsl:decimal-format
结合使用，以指定具体的货币符号（如$或€）。
-
;
(分号)：用于分隔正数和负数的格式模式。例如，
'#,##0.00;(#,##0.00)'
表示正数按常规显示，负数则用括号括起来。
举个例子，如果我有一个销售额
987654.321
，我想显示成美元格式，保留两位小数，并且有千位分隔符，我可能会用
format-number(987654.321, '¤#,##0.00')
。如果
decimal-format
没特殊定义，它可能就显示成
$987,654.32
（取决于默认环境）。
结合实际场景：如何处理不同语言环境下的数字格式？
处理数字格式，特别是涉及到国际化时，
format-number()
函数的第三个参数——
decimal-format-name
就显得尤为重要了。我们知道，不同国家和地区对数字的显示习惯差异很大，比如小数点是点还是逗号，千位分隔符是逗号、点还是空格，甚至负数的表示方式都可能不同。如果只是简单地用
#
和
0
来定义模式，往往无法满足这些复杂的需求。
这时候，XSLT里的
xsl:decimal-format
元素就派上用场了。它允许你定义一套完整的、命名的数字格式规则，然后
format-number()
就可以引用这套规则。这就像是给不同的国家或业务场景预设好了“格式模板”。
xsl:decimal-format
有很多属性，可以让你精细地控制数字的显示：
-
name
：这个格式定义的唯一名称，供
format-number()
引用。
-
decimal-separator
：小数分隔符（默认是
.
）。
-
grouping-separator
：分组分隔符（默认是
,
）。
-
infinity
：无穷大的表示（默认是
infinity
）。
-
NaN
：非数字的表示（默认是
NaN
）。
-
percent
：百分号（默认是
%
）。
-
per-mille
：千分号（默认是
‰
，即‰）。
-
zero-digit
：用于模式中的零的字符（默认是
0
）。
-
digit
：用于模式中的数字的字符（默认是
#
）。
-
pattern-separator
：正负模式之间的分隔符（默认是
;
）。
来看个实际例子，我们要同时支持英语和德语的数字格式：
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <!-- 英语格式定义 --> <xsl:decimal-format name="en-format" decimal-separator="." grouping-separator="," infinity="Infinity" NaN="NaN"/> <!-- 德语格式定义 --> <xsl:decimal-format name="de-format" decimal-separator="," grouping-separator="." infinity="Unendlich" NaN="Keine Zahl"/> <xsl:template match="/"> <output> <number-en> <!-- 使用英语格式模式 --> <xsl:value-of select="format-number(1234567.89, '#,##0.00', 'en-format')"/> </number-en> <number-de> <!-- 使用德语格式模式 --> <xsl:value-of select="format-number(1234567.89, '#.##0,00', 'de-format')"/> </number-de> <nan-en> <xsl:value-of select="format-number(0 div 0, '0', 'en-format')"/> </nan-en> <nan-de> <xsl:value-of select="format-number(0 div 0, '0', 'de-format')"/> </nan-de> </output> </xsl:template> </xsl:stylesheet>
这段代码会输出：
<output> <number-en>1,234,567.89</number-en> <number-de>1.234.567,89</number-de> <nan-en>NaN</nan-en> <nan-de>Keine Zahl</nan-de> </output>
你看，通过
xsl:decimal-format
，我们不仅改变了分隔符，连
NaN
的显示都能本地化。这才是真正意义上的国际化数字格式化。在构建多语言系统时，这几乎是不可或缺的。
常见格式化陷阱与我的解决心得
我在用
format-number()
的时候，也踩过不少坑，有些问题看起来小，但处理起来却能让人抓狂。这里分享几个我遇到的常见陷阱和一些心得。
一个很经典的误区就是
#
和
0
的混淆。我见过不少人，想要固定小数位数时，用了
#.##
，结果发现
12.00
变成了
12
，而不是预期的
12.00
。这时候，正确的姿势是使用
0
，比如
#,##0.00
。
0
是强制占位符，它会确保即使没有有效数字，那个位置也会显示一个零。记住，
#
是“可选显示”，
0
是“强制显示”。这个小细节，经常能解决很多头疼的格式问题。
另一个让人头大的情况是，当数字本身就是
NaN
（Not a Number）或
infinity
（无穷大）时。如果你不通过
xsl:decimal-format
明确指定它们的显示方式，默认输出的
NaN
和
infinity
可能不符合你的界面要求，甚至在某些语言环境下显得非常突兀。所以，如果你处理的数据源可能包含这些特殊数值，一定要在
xsl:decimal-format
中预设好
NaN
和
infinity
属性，让它们以更友好的文本呈现。我通常会把它们定义成“无效数据”或“N/A”，这样用户看到时至少知道发生了什么，而不是一串冰冷的技术词汇。
还有就是模式字符串的复杂性。有时候，为了实现一个非常精细的格式，比如正数、负数、零值分别有不同的显示方式，模式字符串会变得很长，比如
'#,##0.00;(#,##0.00);Zero'
。这种情况下，调试起来真是个体力活。我的经验是，先从最简单的模式开始，逐步增加复杂度，每增加一个部分就测试一下。如果一次性写一个很复杂的模式，一旦出错，排查起来就像大海捞针。同时，多利用在线的XPath/XSLT测试工具，它们能即时反馈你的格式化结果，大大提高效率。
最后一点心得，是关于性能的。虽然
format-number()
通常不是性能瓶颈，但如果你的XSLT转换需要处理海量数据，并且每个数字都需要复杂的格式化，那么模式的解析和应用也是有开销的。在某些极端情况下，如果你只是需要简单的截断小数位或者补零，有时候直接的字符串函数（如
substring-before
、
concat
）配合
round()
或
floor()
可能会更直接、效率更高。但这通常只在对性能有极致要求时才需要考虑，大部分情况下，
format-number()
的便利性远超其微小的性能开销。总之，它是个强大的工具，但也要知道它的边界和最佳实践。
