XSLT如何定义十进制格式？

答案：XSLT通过xsl:decimal-format定义数字格式规则，并用format-number()函数引用规则来格式化数值，支持小数点、千位分隔符、负号、特殊值等的自定义，适用于多语言和业务场景。

XSLT里要定义十进制格式，核心就是用

xsl:decimal-format

元素来声明一套数字格式规则，然后通过

format-number()

函数引用这套规则来格式化你的数值。它给你提供了极大的灵活性，来处理各种国际化或特定业务的数字显示需求，比如小数点、千位分隔符、负号等等。

解决方案

要定义和使用十进制格式，你需要以下两个步骤：

1. 声明

   xsl:decimal-format

   ： 在你的XSLT样式表的顶层（或者在某个

   xsl:template

   内部，但通常放在顶层以便全局复用）声明一个或多个

   xsl:decimal-format

   元素。每个声明可以有一个

   name

   属性，用于后续引用。如果你不指定

   name

   ，它就成了默认的十进制格式。

   <xsl:stylesheet version="1.0"                 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">      <!-- 定义一个名为 'euro-format' 的十进制格式 -->     <xsl:decimal-format name="euro-format"                         decimal-separator=","                         grouping-separator="."                         minus-sign="-"                         zero-digit="0"                         digit="#"                         infinity="∞"                         NaN="非数字"                         percent="%"                         per-mille="‰"                         pattern-separator=";"/>      <!-- 定义一个默认的十进制格式 (无name属性) -->     <xsl:decimal-format decimal-separator="."                         grouping-separator=","/>      <xsl:template match="/">         <output>             <euro-price>                 <xsl:variable name="price" select="12345.678"/>                 <xsl:value-of select="format-number($price, '#.###,00 €', 'euro-format')"/>             </euro-price>             <default-price>                 <xsl:variable name="price2" select="-9876.5432"/>                 <xsl:value-of select="format-number($price2, '##,###.00')"/>             </default-price>             <special-numbers>                 <xsl:value-of select="format-number(1 div 0, '0', 'euro-format')"/> <!-- Infinity -->                 <xsl:text>, </xsl:text>                 <xsl:value-of select="format-number(0 div 0, '0', 'euro-format')"/> <!-- NaN -->             </special-numbers>         </output>     </xsl:template>  </xsl:stylesheet>

2. 使用

   format-number()

   函数： 在你的XSLT转换逻辑中，使用

   format-number(number, pattern, decimal-format-name)

   函数来格式化数值。第三个参数就是你之前定义的

   xsl:decimal-format

   的

   name

   。如果省略第三个参数，就会使用默认的十进制格式。

   输入XML示例：

   <data>     <value>12345.678</value>     <anotherValue>-9876.5432</anotherValue> </data>

   XSLT转换后的输出示例：

   <output>     <euro-price>12.345,68 €</euro-price>     <default-price>-9,876.54</default-price>     <special-numbers>∞, 非数字</special-numbers> </output>

XSLT中自定义数字格式的必要性与场景解析

我们为什么需要XSLT的

xsl:decimal-format

？初看起来，

format-number()

函数本身就能做一些基本的格式化了，比如

format-number(1234.56, '#,##0.00')

。但这个默认行为，或者说它依赖的默认“格式化环境”，往往不能满足现实世界里各种复杂的、地域性的数字显示习惯。

举个例子，在欧洲大陆很多国家，小数点是用逗号表示的，而千位分隔符则是点。而在英语国家，情况正好相反。如果没有

xsl:decimal-format

，你很难在同一个XSLT里灵活地切换这些规则，或者说，你可能需要写很多条件判断，甚至用字符串操作去“模拟”这种格式化，那简直是噩梦。

xsl:decimal-format

就是为了解决这些痛点而生的。它提供了一个集中的地方来定义这些“本地化”的数字格式约定：

• 小数点和千位分隔符： 这是最常见的需求，比如上面提到的逗号和小点互换。
• 负号表示： 有些财务报表可能要求负数用括号括起来，或者在后面加“Cr”（Credit）而不是前面的减号。

  minus-sign

  属性可以让你定义这个符号。

• 百分比和千分号： 如果你的数字是百分比或千分比，你可以定义它们的符号。
• 非阿拉伯数字： 这是一个比较高级但很实用的功能。在某些语言环境下，比如印度或泰国，数字本身的字符可能不是我们常用的0-9。

  zero-digit

  和

  digit

  属性允许你指定这些字符，这样

  format-number()

  就能输出本地化的数字字符了。这比你想象的要有用，尤其是在做全球化的内容发布时。

• 特殊数值表示： 无穷大（Infinity）和非数字（NaN）在计算中很常见，但它们如何显示？

  infinity

  和

  NaN

  属性让你能自定义它们的字符串表示。

简而言之，它将数字的“值”与“显示形式”解耦，让你能根据不同的上下文或目标受众，灵活地渲染数字。这不仅仅是为了美观，更是为了确保数据在不同文化背景下都能被正确理解。

深入探究

xsl:decimal-format

的高级属性与模式匹配

xsl:decimal-format

的强大之处在于它提供了一系列细粒度的属性，让你几乎可以控制数字格式化的每一个细节。除了前面提到的

decimal-separator

、

grouping-separator

、

minus-sign

，还有几个值得深入了解：

• zero-digit

  和

  digit

  ： 这两个属性定义了用于表示数字的字符。

  zero-digit

  定义了“0”对应的字符，而

  digit

  定义了“#”对应的字符。例如，如果你想用泰语数字来显示，你可以设置

  zero-digit="๐"

  （泰语的0）和

  digit="ๆ"

  （泰语的占位符）。

  format-number()

  会根据你的模式和这些定义，将阿拉伯数字（0-9）映射到你指定的字符集。这是一个非常强大的国际化特性，但使用时需要确保你的字体支持这些字符。

• pattern-separator

  ： 这个属性定义了在

  format-number()

  的

  pattern

  参数中，用于分隔正数和负数模式的字符。默认是分号（

  ;

  ）。例如，

  '#,##0.00;(#,##0.00)'

  表示正数按前者格式化，负数按后者（加括号）格式化。如果你想用其他字符作为分隔符，就可以修改这个属性。

  <xsl:decimal-format name="accounting-format"                     decimal-separator="."                     grouping-separator=","                     pattern-separator="|"/> <!-- 使用 | 作为分隔符 --> <!-- ... --> <xsl:value-of select="format-number($value, '#,##0.00|(#,##0.00)', 'accounting-format')"/>

• infinity

  和

  NaN

  ： 如前所述，它们让你自定义当数值是无穷大或非数字时显示的字符串。这在处理数据错误或计算异常时特别有用，能让输出更具可读性，而不是简单地显示“Infinity”或“NaN”。

理解这些属性，并知道如何在

format-number()

的

pattern

参数中与它们配合使用，是掌握XSLT数字格式化的关键。

pattern

中的

0

表示强制显示数字（不足补零），

#

表示可选数字（不显示前导/后导零），

,

表示分组分隔符的位置，

.

表示小数点的位置。这些模式字符会结合

xsl:decimal-format

中定义的实际符号来渲染。

XSLT十进制格式定义中的常见误区与最佳实践

在使用

xsl:decimal-format

时，有些地方很容易踩坑，或者说有一些最佳实践可以帮助你写出更健壮、更易维护的XSLT代码。

1. 命名冲突与默认格式： 如果你定义了多个

   xsl:decimal-format

   但没有给它们指定

   name

   属性，或者给它们指定了相同的

   name

   ，XSLT处理器会报错或者行为不可预测（通常是最后一个定义的会覆盖前面的）。所以，给你的自定义格式起一个清晰、唯一的名称是至关重要的。同时，记住你可以定义一个没有

   name

   属性的

   xsl:decimal-format

   ，它将作为整个样式表的默认格式，当

   format-number()

   函数不指定第三个参数时就会使用它。这对于设置全局的、大部分数字都遵循的格式非常方便。

2. 模式与格式定义的分离：

   xsl:decimal-format

   定义的是“符号”，比如小数点是点还是逗号，负号是什么。而

   format-number()

   的第二个参数

   pattern

   定义的是“结构”，比如小数点后保留几位，是否显示千位分隔符，正负数模式等。这两者是协同工作的。一个常见的错误是混淆了它们的作用，比如试图在

   xsl:decimal-format

   里定义精度，那是

   pattern

   的职责。

   <!-- 错误示例：试图在decimal-format里定义精度 --> <xsl:decimal-format name="wrong-way" decimal-separator="." grouping-separator="," digit="#.00"/> <!-- 正确的做法是： --> <xsl:decimal-format name="correct-way" decimal-separator="." grouping-separator=","/> <xsl:value-of select="format-number($value, '#,##0.00', 'correct-way')"/>

3. 国际化与语言环境：

   xsl:decimal-format

   的

   lang

   属性是建议性的，它告诉处理器这个格式是为哪个语言环境设计的，但处理器不一定会根据这个属性自动调整所有符号。你仍然需要手动设置

   decimal-separator

   、

   grouping-separator

   等属性来匹配特定语言环境的习惯。XSLT本身并不提供像Java或.NET那样完整的、基于Locale的自动数字格式化能力，它更多是提供了一个框架让你能手动定义这些本地化规则。所以，如果你要支持多种语言，你需要为每种语言定义一套

   xsl:decimal-format

   。

4. 性能考量： 虽然

   xsl:decimal-format

   的定义通常是静态的，对性能影响不大，但如果在非常大的XML文档上进行大量的

   format-number()

   操作，确保你的

   xsl:decimal-format

   定义是高效且准确的，避免不必要的查找或解析开销。

总的来说，

xsl:decimal-format

是XSLT处理数字格式化的基石。通过理解它的属性和与

format-number()

的协同工作方式，你可以灵活地应对各种复杂的数字显示需求，确保你的数据在任何语境下都能以最恰当、最符合预期的形式呈现。