1. date, time, datetime(当用于日期/时间/日期-时间值时)
1.1. date:仅日期部分, 没有一天当中的时间部分。
1.2. time:仅一天当中的时间部分, 没有日期部分。
1.3. datetime:日期和时间都在。
1.4. 在最佳情况下, 你不需要使用这些内建函数。不幸的是, 由于Java平台上的技术限制, FreeMarker有时不能发现日期中的哪一部分在使用; 询问程序员哪些变量会有这个问题。如果FreeMarker 不得不执行需要这些信息的操作 --比如用文本显示日期--但是它不知道哪一部分在使用, 它会以错误来中止运行。这就是你不得不使用这些内建函数的时候了。
1.5. 如果?左边是字符串, 那么这些内建函数将字符串转换成日期/时间/日期时间。
2. date_if_unknown, time_if_unknown, datetime_if_unknown
2.1. date_if_unknown, time_if_unknown, datetime_if_unknown内建函数使用一些子类型来标记日期类型的值。日期没有时间, 时间, 或日期-时间类型。 如果变量值已经持有这些信息, 那么内建函数就不会起作用。也就是说, 它不会转换变量值的子类型, 如果它是未知的, 则会添加子类型。
3. string(当用于日期/时间/日期-时间值时)
3.1. 这个内建函数以指定的格式转换日期类型到字符串类型。
3.2. 期望的格式可以由?string.format或?string["format"](或历史上等同的, ?string("format"))来指定, 这些都是等同的。除了使用引号格式的, 它可以在format中包含任意字符, 比如空格。format的语法和配置设置项date_format, time_format和datetime_format是一样的。
4. 例子
4.1. 新建一个名为FMBuiltInsForDateTime的动态Web工程, 同时添加相关jar包。
4.2. 编写FMFactory.java
package com.fm.util;
import java.util.Locale;
import java.util.Map;
import java.util.TimeZone;
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.setLocale(Locale.CHINA);
// 时区设置
cfg.setTimeZone(TimeZone.getTimeZone("GMT+08"));
// sql时区设置
cfg.setSQLDateAndTimeTimeZone(TimeZone.getTimeZone("GMT+08"));
// 日期格式化
cfg.setDateFormat("yyyy-MM-dd");
// 时间格式化
cfg.setTimeFormat("HH:mm:ss.SSS");
// 日期时间格式化
cfg.setDateTimeFormat("yyyy-MM-dd HH:mm:ss.SSS");
cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
map.put(path, cfg);
return cfg;
}
}
4.3. 编写BuiltInsForDateTime.java
package com.fm.action;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.sql.Time;
import java.sql.Timestamp;
import java.util.Date;
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 BuiltInsForDateTime 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("builtinsfordatetime.html");
Map<String, Object> root = new HashMap<String, Object>();
root.put("javaDate", new Date(System.currentTimeMillis()));
root.put("sqlDate", new java.sql.Date(System.currentTimeMillis()));
root.put("sqlTime", new Time(System.currentTimeMillis()));
root.put("sqlTimestamp", new Timestamp(System.currentTimeMillis()));
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);
}
}
4.4. 修改web.xml
4.5. 在/WEB-INF/templates下编写builtinsfordatetime.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>日期内建函数</title>
</head>
<body>
<h2>date, time, datetime</h2>
${javaDate?date}<br />
${javaDate?time}<br />
${javaDate?datetime}<br />
${sqlDate}<br />
${sqlTime}<br />
${sqlTimestamp}<br />
${"2021-6-2"?date}<br />
${"19:14:17.289"?time}<br />
${"2021-6-2 19:14:17.289"?datetime}
<h2>date_if_unknown, time_if_unknown, datetime_if_unknown</h2>
${javaDate?date_if_unknown}<br />
${javaDate?time_if_unknown}<br />
${javaDate?datetime_if_unknown}
<h2>string(当用于日期/时间/日期-时间值时)</h2>
${javaDate?string("yyyy-MM-dd")}<br />
${javaDate?string("HH:mm:ss.SSS")}<br />
${javaDate?string("yyyy-MM-dd HH:mm:ss.SSS")}<br />
</body>
</html>
5.6. 运行项目