1. abs
1.1. 给出数字的绝对值。
2. c(当被用作是数字值时)
2.1. 该内建函数将"计算机语言"的数字转换成字符串, 这都是对计算机来说的, 而不是对用户。也就是说, 它根据程序语言的用法来进行格式化, 这对于FreeMarker的所有本地数字格式化设置来说是独立的。它通常使用点来作为小数分隔符, 而且它从来不用分组分隔符(像3,000,000)。
2.2. 它最多在小数点后打印16位。
2.3. 该内建函数非常严格, 因为作为默认(像${x}这样)数字被本地(语言, 国家)特定的数字格式转换为字符串, 这是让用户来看的(比如3000000可能会被打印为3,000,000)。
2.4. 中国本地显示
2.5. 德国本地显示(德国小数点使用逗号, 分隔符使用点号)
3. lower_abc
3.1. 将1, 2, 3等..., 转换为字符串"a", "b", "c"等...当到达"z"时, 那么会继续转换成如: "aa", "ab"等...这和电子表格应用程序(比如Excel或Calc)的列标签有着相同的逻辑。数字的最小值是1。没有上限值。如果数字是0或更小或它不是整数, 那么模板处理将会中止并发生错误。
4. upper_abc
4.1. 和lower_abc相同, 但是它转换成大写字母, 比如: "A", "B", "C", … , "AA", "AB", 等...
5. round
5.1. round: 返回最近的整数。如果数字以.5结尾, 那么它将进位(也就是向正无穷方向进位)。
6. floor
6.1. floor: 返回数字的舍掉小数后的整数(也就是向负无穷舍弃)。
7. ceiling
7.1. ceiling: 返回数字小数进位后的整数(也就是向正无穷进位)。
8. string(当用作是数字类型时)
8.1. 将一个数字转换成字符串。它使用程序员通过number_format和locale设置的默认格式。也可以明确地用这个内建函数再指定一个数字格式。
8.2. 有四种预定义的数字格式: computer, currency(货币), number和percent。这些格式的明确含义是本地化(国家)指定的, 受Java平台安装环境所控制, 而不是FreeMarker。
8.3. computer和c内建函数是相同的格式。
8.4. Java数字格式语法(java.text.DecimalFormat)
8.4.1. pattern="0", 这里的0代表数字, 如果number的位数大于等于pattern的0的个数, result=number。否则不够的位数以0填充。
8.4.2. #号和0的含义相同, 都是代表数字, 不同的是其不会用0填充, 不够位数就不显示。
8.4.3. E使用科学计数法。
8.4.4. 在金融和统计学实践中, 四舍五入都是根据所谓的一半原则, 这就意味着对最近的"邻居"进行四舍五入, 除非离两个邻居距离相等, 这种情况下, 它四舍五入到偶数的邻居。
9. 例子
9.1. 新建一个名为FMBuiltInsForNumber的动态Web工程, 同时添加相关jar包。
9.2. 编写FMFactory.java
package com.fm.util;
import java.util.Locale;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import freemarker.template.Configuration;
import freemarker.template.TemplateExceptionHandler;
public class FMFactory {
private final static FMFactory instance = new FMFactory();
private FMFactory() {}
public static FMFactory getInstance() {
return instance;
}
private Map<String, Configuration> map = new ConcurrentHashMap<String, Configuration>();
// 创建单个Configuration实例
public synchronized Configuration getCfg(Object servletContext, String path) {
if(null != map.get(path)) {
return map.get(path);
}
Configuration cfg = new Configuration(Configuration.VERSION_2_3_22);
cfg.setServletContextForTemplateLoading(servletContext, path);
cfg.setDefaultEncoding("utf-8");
// 数值格式化模式
cfg.setNumberFormat("computer");
// 本地化设置, 中文中国
cfg.setLocale(Locale.CHINA);
cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
map.put(path, cfg);
return cfg;
}
}
9.3. 编写FMBuiltInsForNumber.java
package com.fm.action;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.fm.util.FMFactory;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
public class FMBuiltInsForNumber extends HttpServlet {
private static final long serialVersionUID = 1L;
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
Configuration cfg = FMFactory.getInstance().getCfg(req.getServletContext(), "/WEB-INF/templates");
Template template = cfg.getTemplate("builtinsfornumber.html");
Map<String, Object> root = new HashMap<String, Object>();
Writer out = new OutputStreamWriter(resp.getOutputStream());
try {
template.process(root, out);
} catch (TemplateException e) {
e.printStackTrace();
}
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
9.4. 修改web.xml
9.5. 在/WEB-INF/templates下编写builtinsfornumber.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>数字内建函数</title>
</head>
<body>
<h2>给出数字的绝对值</h2>
${-5?abs}
<h2>c(当被用作是数字值时)</h2>
300000: ${300000}<br />
0.333333333333333333355555555: ${0.333333333333333333355555555}<br />
300000?c: ${300000?c}<br />
0.333333333333333333355555555?c: ${0.333333333333333333355555555?c}
<h2>将1, 2, 3等..., 转换为字符串"a", "b", "c"等</h2>
<#list 1..30 as n>${n?lower_abc} </#list>
<h2>将1, 2, 3等..., 转换为字符串"A", "B", "C"等</h2>
<#list 1..30 as n>${n?upper_abc} </#list>
<h2>返回最近的整数</h2>
${3.1?round}<br />
${3.5?round}<br />
${3.9?round}
<h2>返回数字的舍掉小数后的整数</h2>
${3.1?floor}<br />
${3.5?floor}<br />
${3.9?floor}
<h2>返回数字小数进位后的整数</h2>
${3.1?ceiling}<br />
${3.5?ceiling}<br />
${3.9?ceiling}
<h2>string(当用作是数字类型时)</h2>
<#assign x=4200>
${x}<br />
<#-- the same as ${x} -->
string: ${x?string}<br />
string.computer: ${x?string.computer}<br />
<#-- string.currency货币格式 -->
string.currency: ${x?string.currency}<br />
string.number: ${x?string.number}<br />
string.percent: ${x?string.percent}
${x?string["0"]}<br /><br />
1.234使用"0.#"模式: ${1.234?string["0.#"]}<br />
1.234使用"0.##"模式: ${1.234?string["0.##"]}<br />
1.234使用"0.###"模式: ${1.234?string["0.###"]}<br />
1.234使用"0.####"模式: ${1.234?string["0.####"]}<br /><br />
1使用"000.00"模式: ${1?string["000.00"]}<br />
12.1使用"000.00"模式: ${12.1?string["000.00"]}<br />
123.456使用"000.00"模式: ${123.456?string["000.00"]}<br /><br />
1.2使用"0"模式: ${1.2?string["0"]}<br />
1.8使用"0"模式: ${1.8?string["0"]}<br />
1.5使用"0"模式: ${1.5?string["0"]}<br />
2.5使用"0"模式: ${2.5?string["0"]}<br /><br />
12345使用"0.##E0"模式: ${12345?string["0.##E0"]}
</body>
</html>
9.6. 运行项目