012_日期内建函数

最新推荐文章于 2022-11-08 14:55:57 发布

原创最新推荐文章于 2022-11-08 14:55:57 发布 · 197 阅读

0 ·

CC 4.0 BY-SA版权

FreeMarker学习专栏收录该内容

24 篇文章

订阅专栏

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. 运行项目