freemarker数字格式化可以在两个地方设置,一个是全局的,即在freemarker.properties文件中设置number_format,还有一个是使用string指令来控制数据的输出格式。例如:
关于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"]}
将会输出:
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
一、使用内建函数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.70 freemarker数字格式化带来的操作问题 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:
相关的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=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
设置的默认格式。也可以明确地用这个内建函数再指定一个数字格式, 这在后面会展示。
有四种预定义的数字格式: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 版本开始存在。
和 lower_abc
相同, 但是它转换成大写字母,比如 "A"
, "B"
, "C"
,… , "AA"
, "AB"
, 等...