FreeMarker 数字内建函数（取值）

freemarker数字格式化可以在两个地方设置，一个是全局的，即在freemarker.properties文件中设置number_format，还有一个是使用string指令来控制数据的输出格式。例如：${num?string('0.00')}如果小数点后不足两位，用 0 代替${num?string('#.##')}如果小数点后多余两位，就只保留两位，否则输出实际值输出为：1239765.46${num?string(',###.00')}输出为：1,239,765.46整数部分每三位用 , 分割，并且保证小数点后保留两位，不足用 0 代替${num?string(',###.##')}输出为：1,239,765.46整数部分每三位用 , 分割，并且小数点后多余两位就只保留两位，不足两位就取实际位数，可以不不包含小数点${num?string('000.00')}输出为：012.70整数部分如果不足三位（000），前面用0补齐，否则取实际的整数位${num?string('###.00')}等价于${num?string('#.00')}输出为：12.70整数取实际的位数关于string指令的更多用法，可以访问官方文档：http://freemarker.sourceforge.net/docs/ref_builtins_number.html#ref_builtin_string_for_number

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

将会输出：

11.21.231.2341.234001.00012.10123.46122 <-- 1.5, rounded towards even neighbor2 <-- 2.5, rounded towards even neighbor1.23E4

一、使用内建函数c特点：不管其表现形式是怎样的（例如"123,456.123,456"、"123456.123456"、"000123456.123456000"、"123,456.123456"、"1,2345,6.123456")，只要小数分割符是'.'它就能转化成计算机能够识别的字符串形式，而且都是123456.123456,计算机处理的时候是没有那些所谓的千位分隔符的（空格或逗号），而且计算机支持的最大的小数点后面的位数是16位，目前来说，已经够我们用了。用法:假设strmun是一个字符串形式的数字，则可以这样写${strnum?c},例如${"123,456.123,456"?c}值为123456.123456可能用处：对一些表单允许用户按照个人习惯输入数字，提交的时候统一转换二、使用预定义的数字格式有四种预定义的数字格式，分别是computer（跟内建函数c功能一样，用法不一样）、currency（货币格式）、number（数字格式）、percent（百分比形式）特点：这些格式的明确含义是本地化（国家）指定的，受Java平台安装环境所控制，而不是FreeMarker，所以不建议用这些函数，而且受默认数字格式的影响，用法不灵活。三、使用类似于Java中数字格式语法形式特点：例如"0.#",左边的'0'的个数代表整数部分最少为多少位，右边'#"的个数代表小数部分最多为多少位;例如",##0.0#"表示整数部分的千位分割符是','，小数部分最多保留两位，最少保留一位；例如"0.##%"以百分比的形式表示，小数部分最多两位。用法:假设strnum是一个数字，则可以这样写${strnum?string(",##0.0#")},例如${123456.123456?string(",##0.0#")}值为123,456.12注意：数字格式是本地化敏感的，不过我们一般都会给freemarker设置默认的本地化语言，问题不大。可能用处：当在某一个地方突然要用到数字格式时，调用string函数是可以的，当在很多地方都需要用到数字格式是，这样处理太麻烦了，可以考虑设置默认的数字格式化形式四、局部设置特点：如果在某个页面，或者某几个页面（其它页面可import进来），用到的数字格式化是相同的，可考虑统一配置数字的格式化形式用法：只需在用到需要格式化的数字之前设置就可以了，格式如下：<#settingnumber_format=",##0.##">其中",##0.##"的内容是采用类似于java中数字格式的语法形式，也就是以上的第三点。注意：如果用在一个页面，则整个页面默认就是那种格式，除非用string函数覆盖了默认的格式，同样的，如果放在一个公共的页面，其它页面只要include它，也会是同样的格式。五、全局设置特点：在所有的页面都默认提供数字的格式化形式用法（针对spring）：在freemarker的配置文件中设置其默认的数字格式化形式，如下：复制代码 代码如下:<propertyname="freemarkerSettings"><props>.....<propkey="number_format">0.##</prop>......</props></property>六、舍入处理有几种舍入处理方式，分别是 round,floor,ceiling 和string("0")特点：前面三种，从字面上很好理解，我们也经常使用，要说的最后一种，先看一个例子1.5?string("0")和2.5?string("0") 的值都是2 说明如下：在金融和统计学中，四舍五入都是根据所谓的一半原则，这就意味着对最近的“邻居”进行四舍五入，除非离两个邻居距离相等，这种情况下，它四舍五入到偶数的邻居。如果你注意看 1.5 和 2.5 的四舍五入的话，这在上面的示例中是可以看到的，两个都被四舍五入到2，因为 2 是偶数，但 1 和 3 是奇数。用法：假设strnum是一个数字，则可以这样写${strnum?round(floor/ceiling)} 或者${strmun?string("0")}可能用法：可用在一些对数字精确度不高的情况(分页处理时也许有用)，一些对小数敏感的，还是用 string函数例如：复制代码 代码如下:${num?string('0.00')}如果小数点后不足两位，用 0 代替复制代码 代码如下:${num?string('#.##')}如果小数点后多余两位，就只保留两位，否则输出实际值输出为：1239765.46复制代码 代码如下:${num?string(',###.00')}输出为：1,239,765.46整数部分每三位用 , 分割，并且保证小数点后保留两位，不足用 0 代替复制代码 代码如下:${num?string(',###.##')}输出为：1,239,765.46整数部分每三位用 , 分割，并且小数点后多余两位就只保留两位，不足两位就取实际位数，可以不不包含小数点复制代码 代码如下:${num?string('000.00')}输出为：012.70整数部分如果不足三位（000），前面用0补齐，否则取实际的整数位复制代码 代码如下:${num?string('###.00')}等价于复制代码 代码如下:${num?string('#.00')}输出为：12.70freemarker数字格式化带来的操作问题freemarker在解析数据格式的时候，自动默认将数字按3为分割（1，000），这个问题给操作带来一定的额外处理复杂度，解决方法有如下几种：1、在模板中直接加.toString()转化数字为字符串，如：复制代码 代码如下:${languageList.id.toString()}；2、在freemarker配置文件freemarker.properties加复制代码 代码如下:<#setting number_format="#">或者 <#setting number_format="0">；3、在模板中直接加<#setting number_format="#">或者<#setting number_format="0">，如：<#if复制代码 代码如下:AdminLanguagePaginationMsg?exists><#setting number_format="#">对于数字的格式化，可采用strng 和number_format 设置数字格式化的优先级： string优先级最高，配置文件配置的优先级最低，在页面setting的优先级在两者之间。七、总结对于数字的格式化，可采用strng和number_format设置数字格式化的优先级：string优先级最高，配置文件配置的优先级最低，在页面setting的优先级在两者之间。

API：

Page Contentsabsc (当被用作是数字值时)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} </#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

请参考： 

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

输出：

    0 ?floor=0 ?ceiling=0 ?round=01 ?floor=1 ?ceiling=1 ?round=1-1 ?floor=-1 ?ceiling=-1 ?round=-10.5 ?floor=0 ?ceiling=1 ?round=11.5 ?floor=1 ?ceiling=2 ?round=2-0.5 ?floor=-1 ?ceiling=0 ?round=0-1.5 ?floor=-2 ?ceiling=-1 ?round=-10.25 ?floor=0 ?ceiling=1 ?round=0-0.25 ?floor=-1 ?ceiling=0 ?round=01.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，将会输出：

424242$42.004,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.0042$42.004,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"]}

将会输出：

11.21.231.2341.234001.00012.10123.46122 <-- 1.5, rounded towards even neighbor2 <-- 2.5, rounded towards even neighbor1.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.00German people write: 12.345.678,00

upper_abc

Note:该内建函数从 FreeMarker 2.3.22 版本开始存在。和 

lower_abc

 相同， 但是它转换成大写字母，比如 

"A"

， 

"B"

， 

"C"

，… ， 

"AA"

， 

"AB"

， 等...