@DateTimeFormat 和 @JsonFormat 註解

1. 準備
定義一個pojo，它有一個 java.util.Date 類型的屬性 date。

import java.util.Date;
 
public class DateVo {
    private Date date;
 
    public void setDate(Date date){
        this.date = date;
    }
    public Date getDate(){
        return date;
    }
}
定義一個Controller

@RestController
@RequestMapping("/date/")
public class DateController {
 
    @RequestMapping("test")
    public DateVo getDate(DateVo vo){
        System.out.println("date1:"+vo.getDate());
 
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String date = sdf.format(vo.getDate());
        System.out.println("date2:"+date);
 
        DateVo vo2 = new DateVo();
        vo2.setDate(new Date());
        return vo2;
    }
}
訪問 /date/test ，並傳入參數：2018-08-02 22:05:55

發現並不能訪問成功，會拋出異常：

由於傳入的參數是 String 類型的，而用來接收參數的 DateVo 的 date 屬性是 java.util.Date 類型的，類型沒法轉換。

2. 入參格式化
這時，就可使用 Spring 的 @DateTimeFormat 註解格式化參數，來解決上述問題。

改造 DateVo：

public class DateVo {
    @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss")
    private Date date;
 
    public void setDate(Date date){
        this.date = date;
    }
    public Date getDate(){
        return date;
    }
}
再像上面同樣訪問 /date/test ，並傳入參數：2018-08-02 22:05:55，將在控制檯上打印：

date1:Thu Aug 02 22:05:55 CST 2018

date2:2018-08-02 22:05:55

能夠看到，加入 @DateTimeFormat 註解後參數能夠被接收到了，但日期時間的格式仍是須要本身再手動轉換一下。

由於 @DateTimeFormat 註解的 pattern 屬性值指定的日期時間格式並非將要轉換成的日期格式，這個指定的格式是和傳入的參數對應的，假如註解爲：

@DateTimeFormat(pattern="yyyy/MM/dd HH:mm:ss")

則傳入的參數應該是這樣的：

2018/08/02 22:05:55

不然會拋出異常。

3. 出參格式化
在上述示例中，調用接口的返回結果爲：

"date": "2018-08-01T14:25:31.296+0000"

這個格式並非咱們想要的，那麼如何將其進行格式化？這時就須要用到 jackson 的 @JsonFormat 註解。

改造 DateVo：

public class DateVo {
    @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss")
    @JsonFormat(
            pattern = "yyyy-MM-dd HH:mm:ss"
    )
    private Date date;
 
    public void setDate(Date date){
        this.date = date;
    }
    public Date getDate(){
        return date;
    }
}
繼續訪問 /date/test ，並傳入參數：2018-08-02 22:05:55，能夠看到接口返回的結果爲：

"date": "2018-08-01 14:32:57"

雖然時間格式正確了，但實際上當前時間是 「2018-08-01 22:32:57」 ，早了8個小時。由於，jackson在序列化時間時是按照國際標準時間GMT進行格式化的，而在國內默認時區使用的是CST時區，二者相差8小時。

因此，@JsonFormat 註解還要再加一個屬性：

@JsonFormat(
    pattern = "yyyy-MM-dd HH:mm:ss"，
    timezone = "GMT+8"
)
private Date date;
這樣，結果就正確了。

由於 @JsonFormat 註解不是 Spring 自帶的註解，因此使用該註解前須要添加 jackson 相關的依賴包。固然，若是是 SpringBoot 項目就不須要本身手動添加依賴了，由於在 spring-boot-start-web 下已經包含了 jackson 相關依賴。

--------------------- 
做者：月下泛舟 
來源：CSDN 
原文：https://blog.csdn.net/zhou520yue520/article/details/81348926 
版權聲明：本文爲博主原創文章，轉載請附上博文連接！

 pattern 屬性：字符串。解析/格式化字段數據的模式，
例如：」yyyy-MM-dd hh:mm:ss」

iso 屬性： DateTimeFormat.ISO。解析/格式化字段數據
的ISO模式，包括四種：ISO.NONE（不使用） -- 默
認、ISO.DATE(yyyy-MM-dd) 、ISO.TIME(hh:mm:ss.SSSZ)、
ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)

style 屬性：字符串類型。經過樣式指定日期時間的格式，由兩位字
符組成，第一位表示日期的格式，第二位表示時間的格式：S：短日
期/時間格式、M：中日期/時間格式、L：長日期/時間格式、F：完整
日期/時間格式、-：忽略日期或時間格式，默認：SS