FreeMarker中的日期时间处理

1. FreeMarker中的日期时间格式设置

FreeMarker中可以分别对date、time、datetime三种类型的日期时间设置格式，例如：

config.setDateTimeFormat("yyyy-MM-dd HH:mm:ss");  
config.setDateFormat("yyyy-MM-dd");  
config.setTimeFormat("HH:mm:ss"); 

当我们对一个页面变量使用 ?date ?time ?datetime 时就会分别按以上设置的对应格式显示。

2. 什么情况下可以不使用 ?date ?time ?datetime

FreeMarker会将 java.sql.Date java.sql.Time java.sql.Timestamp 类型的变量自动识别为 date time datetime。所以当变量是以上三种类型时，FreeMarker会自动匹配设置的格式，不需要在变量的后面加上?date ?time ?datetime 。

3. 变量为 java.util.Date 类型时的困惑

FreeMarker无法自动识别 java.util.Date 类型应该显示哪种格式，这时需要明确的指定其要显示的格式，否则FreeMarker将会抛出异常。但有些时候我们发现 java.util.Date 类型的变量没有指定格式在页面也能正确显示，这是什么情况？例如：

@Entity
@Table(name = "Tmp_Company")
public class Company extends UuidEntity {
    ...
    /** 成立日期 */
    @Temporal(TemporalType.DATE)
    private java.util.Date foundDate;
    ...
}

在查看页面使用${company.foundDate} 时，没有指定格式却能够正确显示。这是因为@Temporal(TemporalType.DATE) 注解让ORM框架在从数据库中取出数据后将 java.util.Date 类型自动转换成了 java.sql.Date 类型，这时FreeMarker会自动识别其格式。假如在这个业务实体类上加上@Cache 注解，分别使用不同的缓存策略，还会出现更有意思的现象，这里就不展开说了。

4. 结论

当变量类型是 java.sql.Date java.sql.Time java.sql.Timestamp 时，可以不用指定格式；当变量类型是 java.util.Date 时，指定格式才是最稳妥的办法。

5. 补充

如果上例中的foundDate允许为null时，在页面怎么写才会不报错呢？

${foundDate?date!}  
${(foundDate?date)!}  
${foundDate!?date}  
${(foundDate!)?date} 

已经是很丑陋的写法了吧，但以上写法都是错误的，正确的只能这么写：

${(foundDate?string("yyyy-MM-dd"))!}