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

将会输出：

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 代替 

  
  
  

   
   
   复制代码 代码如下: