freemarker方法调用 freemarker function

数字内建函数

<#--  true  -->
${5?is_number?string}

---

1.abs

给出数字的绝对值

<#--  9  -->
${(-9)?abs}

2.c(当被用作是数字值时)

数字转换成字符串，当你在页面中要显示带小数的数字时，

一定要写成{x?c}而不能写成${x?default(’’)}，
否则显示出的数字都变成了整数，小数位都被自动截掉了

3.is_infinite

辨别数字是否是无限浮点数

<#--  true  -->
${5?is_number?string}
<#--  false  -->
${5?is_infinite?string}

4.is_nan

基于 someNumber 的值是否是 NaN，

someNumber?is_nan 结果是 true 或 false，
当然， 如果该数不是浮点类型，那么将会返回 false

5.lower_abc/upper_abc

将 1， 2， 3，等...，转换为字符串 "a"， "b"， "c"，等... 当到达 "z"时，

那么会继续转换成如 “aa”， “ab”，等… 这和电子表格应用程序(比如Excel或Calc) 的列标签有着相同的逻辑。

数字的最小值是 1。 没有上限值。
如果数字是 0 或更小或它不是整数， 那么模板处理将会中止并发生错误

<#--  a  -->
${1?lower_abc}
<#--  ab   -->
${28?lower_abc}
<#--  cu  -->
${99?lower_abc}

upper_abc和 lower_abc 相同， 但是它转换成大写字母，比如 “A”， “B”， “C”，… ， “AA”， “AB”， 等…

<#--  A   -->
${1?upper_abc}
<#--  AB    -->
${28?upper_abc}
<#--  CU  -->
${99?upper_abc}

<#list 1..30 as n>${n?lower_abc} </#list>

6.round, floor, ceiling

使用确定的舍入法则，转换一个数字到整数：

• 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>

7.string (当用作是数字类型时)

将一个数字转换成字符串

<#--  42  -->
${x}
<#--  42  -->
${x?string}  <#-- the same as ${x} -->
<#--  42  -->
${x?string.number}
<#--  ￥42.00  -->
${x?string.currency}
<#--  4,200%  -->
${x?string.percent}
<#--  42  -->
${x?string.computer}
前三个表达式的输出是相同的，因为前两个表达式是默认格式， 这里是"数字"

可以使用一个设置来改变默认设置：使默认的数字格式被设置成了"货币"。

<#setting number_format="currency">
<#assign x=42>
<#--  ￥42.00  -->
${x}
<#--  ￥42.00  -->
${x?string}  <#-- the same as ${x} -->
<#--  42  -->
${x?string.number}
<#--  ￥42.00   -->
${x?string.currency}
<#--  4,200%  -->
${x?string.percent}

除了这三种预定义格式，还可以使用 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"]}

在 FreeMarker 中，foo.bar 和 foo[“bar”] 是相同的，

也可以将 x?string.currency 写为 x?string[“currency”]，当然实际中不这么用。

但是在上述示例中，我们不得不使用方括号语法，

因为在语法上， 使用的字符(数字，点，#)不允许在点操作符之后。

由于历史原因，也可以编写如下代码 x?string(“0.#”)，它和 x?string[“0.#”] 完全相同

<#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}