PreviousNext
数字内建函数
Page Contents
absc (当被用作是数字值时)is_infiniteis_nanlower_abcround, floor, ceilingstring (当用作是数字类型时)upper_abc 相关的FAQ：如果有和 1,000,000 或 1 000 000 而不是 1000000 类似的东西，
或者是 3.14 而不是 3,14 的东西，反之亦然，请参考这里 和 这里 FAQ中相关内容，
也要注意上述内容中的内建函数 c。
abs
Note:
该内建函数从 FreeMarker 2.3.20 版本开始存在。
给出数字的绝对值。比如
x?abs ，如果 x 是 -5，会得到5。
c (当被用作是数字值时)
Note:
该内建函数从 FreeMarker 2.3.3 版本开始存在。
该内建函数将 "计算机语言" 的数字转换成字符串，
这都是对计算机来说的，而不是对用户。也就是说，
它根据程序语言的用法来进行格式化，
这对于 FreeMarker 的所有本地数字格式化设置来说是独立的。
它通常使用点来作为小数分隔符，而且它从来不用分组分隔符(像3,000,000)，
指数形式(比如5E20)，多余的在开头或结尾的0(比如03或1.0)，还有+号(比如+1)。
它最多在小数点后打印16位，因此数值的绝对值小于1E-16将会显示为0。
该内建函数非常严格，因为作为默认(像 ${x} 这样)
数字被本地(语言，国家)特定的数字格式转换为字符串，这是让用户来看的
(比如3000000可能会被打印为3,000,000)。当数字不对用户打印时
(比如，对于一个数据库记录ID，用作是URL的一部分，或者是HTML表单中的隐藏域，
或者打印CSS/JavaScript的数值文本)，该内建函数必须被用来打印数字
(也就是使用 ${x?c} 来代替 ${x})，
否则输出可能由于当前数字格式设置，本地化
(比如在一些国家中，小数点不是点，而是逗号)和数值
(像大数可能被分组分隔符"损坏")而损坏。
如果 FreeMarker 配置设置项 incompatible_imporvements
为 2.3.21 (或更高)，该内建函数将会对正无穷/负无穷，IEEE非浮点数各自返回
"INF"， "-INF" 和
"NaN"。这是这些特殊值的XML Schema兼容性表现。
(之前它会返回US本地化下的 java.text.DecimalFormat，
不被任意(通用)计算机语言所理解。)
请注意，该内建函数 也对布尔值起作用。
is_infinite
Note:
该内建函数从 FreeMarker 2.3.20 版本开始存在。
辨别数字是否是无限浮点数(根据IEEE 754)。比如，
基于 someNumber 的值是否是无限，
someNumber?is_infinite 结果是
true 或 false，当然，
如果该数不是浮点类型，那么将会返回 false。
is_nan
Note:
该内建函数从 FreeMarker 2.3.20 版本开始存在。
辨别数字是否是浮点数NaN(根据IEEE 754)。比如，
基于 someNumber 的值是否是 NaN，
someNumber?is_nan 结果是
true 或 false，当然，
如果该数不是浮点类型，那么将会返回 false。
lower_abc
Note:
该内建函数从 FreeMarker 2.3.22 版本开始存在。
将 1， 2，
3，等...，转换为字符串 "a"，
"b"， "c"，等... 当到达
"z"时，那么会继续转换成如 "aa"，
"ab"，等... 这和电子表格应用程序(比如Excel或Calc)
的列标签有着相同的逻辑。数字的最小值是 1。
没有上限值。如果数字是 0 或更小或它不是整数，
那么模板处理将会中止并发生错误。
例如：
<#list 1..30 as n>${n?lower_abc}
输出：
a b c d e f g h i j k l m n o p q r s t u v w x y z aa ab ac ad
请参考： upper_abc
round, floor, ceiling
Note:
内建函数 round 从 FreeMarker 2.3.13 版本开始存在。
使用确定的舍入法则，转换一个数字到整数：
round：返回最近的整数。
如果数字以.5结尾，那么它将进位(也就是向正无穷方向进位)
floor：返回数字的舍掉小数后的整数
(也就是向负无穷舍弃)
ceiling：返回数字小数进位后的整数
(也就是向正无穷进位)
例如：
<#assign testlist=[
0, 1, -1, 0.5, 1.5, -0.5,
-1.5, 0.25, -0.25, 1.75, -1.75]>
<#list testlist as result>
${result} ?floor=${result?floor} ?ceiling=${result?ceiling} ?round=${result?round}
输出：
0 ?floor=0 ?ceiling=0 ?round=0
1 ?floor=1 ?ceiling=1 ?round=1
-1 ?floor=-1 ?ceiling=-1 ?round=-1
0.5 ?floor=0 ?ceiling=1 ?round=1
1.5 ?floor=1 ?ceiling=2 ?round=2
-0.5 ?floor=-1 ?ceiling=0 ?round=0
-1.5 ?floor=-2 ?ceiling=-1 ?round=-1
0.25 ?floor=0 ?ceiling=1 ?round=0
-0.25 ?floor=-1 ?ceiling=0 ?round=0
1.75 ?floor=1 ?ceiling=2 ?round=2
-1.75 ?floor=-2 ?ceiling=-1 ?round=-2
这些内建函数在分页处理时也许有用。如果你仅仅想
展示 数字的舍入形式，那么应该使用 string
内建函数 或者 number_format
设置。
string (当用作是数字类型时)
将一个数字转换成字符串。它使用程序员通过
number_format 和 locale
设置的默认格式。也可以明确地用这个内建函数再指定一个数字格式，
这在后面会展示。
有四种预定义的数字格式：computer，
currency，number 和
percent。这些格式的明确含义是本地化(国家)指定的，
受Java平台安装环境所控制，而不是FreeMarker，除了
computer，用作和 c
内建函数是相同的格式。可以这样来使用预定义的格式：
<#assign x=42>
${x}
${x?string} <#-- the same as ${x} -->
${x?string.number}
${x?string.currency}
${x?string.percent}
${x?string.computer}
如果你本地是US English，将会输出：
42
42
42
$42.00
4,200%
42
前三个表达式的输出是相同的，因为前两个表达式是默认格式，
这里是"数字"。可以使用一个设置来改变默认设置：
<#setting number_format="currency">
<#assign x=42>
${x}
${x?string} <#-- the same as ${x} -->
${x?string.number}
${x?string.currency}
${x?string.percent}
将会输出：
$42.00
$42.00
42
$42.00
4,200%
因为默认的数字格式被设置成了"货币"。
除了这三种预定义格式，还可以使用 Java
数字格式语法 中的任意数字格式：
<#assign x = 1.234>
${x?string["0"]}
${x?string["0.#"]}
${x?string["0.##"]}
${x?string["0.###"]}
${x?string["0.####"]}
${1?string["000.00"]}
${12.1?string["000.00"]}
${123.456?string["000.00"]}
${1.2?string["0"]}
${1.8?string["0"]}
${1.5?string["0"]} <-- 1.5, rounded towards even neighbor
${2.5?string["0"]} <-- 2.5, rounded towards even neighbor
${12345?string["0.##E0"]}
将会输出：
1
1.2
1.23
1.234
1.234
001.00
012.10
123.46
1
2
2 <-- 1.5, rounded towards even neighbor
2 <-- 2.5, rounded towards even neighbor
1.23E4
请注意，在 FreeMarker 中，foo.bar 和
foo["bar"] 是相同的，也可以将
x?string.currency 写为
x?string["currency"]，当然实际中不这么用。
但是在上述示例中，我们不得不使用方括号语法，因为在语法上，
使用的字符(数字，点，#)不允许在点操作符之后。
由于历史原因，也可以编写如下代码
x?string("0.#")，它和
x?string["0.#"] 完全相同。
在金融和统计学实践中，四舍五入都是根据所谓的一半原则，
这就意味着对最近的"邻居"进行四舍五入，除非离两个邻居距离相等，
这种情况下，它四舍五入到偶数的邻居。如果你注意看1.5和2.5的四舍五入的话，
这在上面的示例中是可以看到的，两个都被四舍五入到2，因为2是偶数，但1和3是奇数。
正如之前展示的预定义格式，数字的默认格式可以在模板中设置：
<#setting number_format="0.##">
${1.234}
将会输出：
1.23
请注意，数字格式是本地化敏感的，本地化设置在格式化中起作用：
<#setting number_format=",##0.00">
<#setting locale="en_US">
US people write: ${12345678}
<#setting locale="hu">
German people write: ${12345678}
将会输出：
US people write: 12,345,678.00
German people write: 12.345.678,00
upper_abc
Note:
该内建函数从 FreeMarker 2.3.22 版本开始存在。
和 lower_abc 相同，
但是它转换成大写字母，比如 "A"，
"B"， "C"，… ，
"AA"， "AB"， 等...
PreviousNext