从 FreeMarker 2.3.20 版本开始存在。
返回数字的绝对值。比如:
<#assign x=-5> x=${x?abs}
输出结果:
x=5
从 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, 不被任意 (通用) 计算机语言所理解)
从 FreeMarker 2.3.20 版本开始存在。
辨别数字是否是无限浮点数(根据IEEE 754)。比如, 基于 someNumber 的值是否是无限, someNumber?is_infinite 结果是 true 或 false,当然, 如果该数不是浮点类型,那么将会返回 false。
从 FreeMarker 2.3.20 版本开始存在。
辨别数字是否是浮点数NaN (根据IEEE 754)。比如,基于 someNumber 的值是否是 NaN, someNumber?is_nan 结果是 true 或 false。当然,如果该数不是浮点类型,那么将会返回 false。
实例:
// Java代码,数据模型 Map<String, Object> input = new HashMap<String, Object>(); input.put("nan_val", Float.NaN);
模版文件内容:
<#-- is_nan --> <#if nan_val?is_nan> is_nan = true <#else> is_nan = false </#if>
输出结果:
is_nan = true
内建函数 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} </#list>
输出结果:
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 设置。
将一个数字转换成字符串。数字转换时采用 number_format 和 locale 设置的默认格式。也可以明确地用这个内建函数再指定一个数字格式,这在后面会展示。
string有四种预定义的数字格式: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
从 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} </#list>
输出结果:
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
从 FreeMarker 2.3.22 版本开始存在。
和 lower_abc 相同,但是它转换成大写字母,比如 "A","B","C",…,"AA","AB",等。实例:
<#list 1..30 as n>${n?upper_abc} </#list>
输出结果:
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