Springboot配置返回日期格式化五種方法詳解

第Springboot配置返回日期格式化五種方法詳解目錄格式化全局時間字段1.前端時間格式化（不做無情人）2.SimpleDateFormat格式化（不推薦）3.DateTimeFormatter格式化（不推薦）4.全局時間格式化（推薦）實現(xiàn)原理分析5.部分時間格式化（推薦）總結(jié)應急就這樣

格式化全局時間字段

在yml中添加如下配置：

spring.jackson.date-format=yyyy-MM-ddHH:mm:ss

或者

spring:

jackson:

##格式為yyyy-MM-ddHH:mm:ss

date-format:yyyy-MM-ddHH:mm:ss

##定時區(qū)，解決8小時的時間差問題

time-zone:GMT+8

OK了，你后端全統(tǒng)一了，應急的同志們就這樣就行了，不用學下面的擴展知識，想學習的可以先收藏（建議別收藏，收藏了也不看，要不一口氣看完點個贊，要不別收藏來欺騙自己了）

系統(tǒng)的知識

1.前端時間格式化（不做無情人）

前端工程時間格式化方法，實現(xiàn)代碼如下。

//JS版時間格式化

functiondateFormat(fmt,date){

letret;

constopt={

"Y+":date.getFullYear().toString(),//年

"m+":(date.getMonth()+1).toString(),//月

"d+":date.getDate().toString(),//日

"H+":date.getHours().toString(),//時

"M+":date.getMinutes().toString(),//分

"S+":date.getSeconds().toString()//秒

//有其他格式化字符需求可以繼續(xù)添加，必須轉(zhuǎn)化成字符串

for(letkinopt){

ret=newRegExp("("+k+")").exec(fmt);

if(ret){

fmt=fmt.replace(ret[1],(ret[1].length==1)(opt[k]):(opt[k].padStart(ret[1].length,"0")))

returnfmt;

方法調(diào)用：

letdate=newDate();

dateFormat("YYYY-mm-ddHH:MM:SS",date);

但是我們能對前端小姐姐這么殘忍嗎？？？？？就像下面的前端小姐姐這么可愛，你忍心？？？？？

不，我們不能，堅決在后端改?。。。。?！

2.SimpleDateFormat格式化（不推薦）

使用SimpleDateFormat來進行時間格式化，它也是JDK8之前重要的時間格式化方法，它的核心實現(xiàn)代碼如下：

//定義時間格式化對象和定義格式化樣式

SimpleDateFormatdateFormat=newSimpleDateFormat("yyyy-MM-ddHH:mm:ss");

//格式化時間對象

Stringdate=dateFormat.format(newDate())

接下來我們使用SimpleDateFormat來實現(xiàn)一下本項目中的時間格式化，它的實現(xiàn)代碼如下：

@RequestMapping("/list")

publicListUsergetList(){

//定義時間格式化對象

SimpleDateFormatdateFormat=newSimpleDateFormat("yyyy-MM-ddHH:mm:ss");

ListUserlist=userMapper.getList();

//循環(huán)執(zhí)行時間格式化

list.forEach(item-{

//使用預留字段ctime接收createtime格式化的時間(Date-String)

item.setCtime(dateFormat.format(item.getCreatetime()));

item.setUtime(dateFormat.format(item.getUpdatetime()));

returnlist;

但是這樣會產(chǎn)生新的問題，為什么接口的返回字段咋變了呢，之前的字段是createtime現(xiàn)在卻是ctime。

這是因為使用SimpleDateFormat.format方法之后，它返回的是一個String類型的結(jié)果，而我們之前的createtime和updatetime字段都是Date類型的，因此它們是不能接收時間格式化得結(jié)果的。

3.DateTimeFormatter格式化（不推薦）

JDK8之后，我們可以使用DateTimeFormatter來替代SimpleDateFormat，因為SimpleDateFormat是非線程安全的，而DateTimeFormatter是線程安全的，所以如果是JDK8以上的項目，盡量使用DateTimeFormatter來進行時間格式化。

DateTimeFormatter格式化的代碼和SimpleDateFormat類似，具體實現(xiàn)如下：

@RequestMapping("/list")

publicListUsergetList(){

//定義時間格式化對象

DateTimeFormatterdateFormat=DateTimeFormatter.ofPattern("yyyy-MM-ddHH:mm:ss");

ListUserlist=userMapper.getList();

//循環(huán)執(zhí)行時間格式化

list.forEach(item-{

//使用預留字段ctime接收createtime格式化的時間(Date-String)

item.setCtime(dateFormat.format(item.getCreatetime()));

item.setUtime(dateFormat.format(item.getUpdatetime()));

returnlist;

DateTimeFormatter和SimpleDateFormat在使用上的區(qū)別是DateTimeFormatter是用來格式化JDK8提供的時間類型的，如LocalDateTime，而SimpleDateFormat是用來格式化Date類型的，所以我們需要對Userer實體類做如下的修改：

importcom.fasterxml.jackson.annotation.JsonIgnore;

importlombok.Data;

importjava.time.LocalDateTime;

@Data

publicclassUser{

privateintid;

privateStringusername;

@JsonIgnore

privateLocalDateTimecreatetime;

privateStringctime;

@JsonIgnore

privateLocalDateTimeupdatetime;

privateStringutime;

}

我們可以使用LocalDateTime來接收MySQL中的datetime類型。

4.全局時間格式化（推薦）

以上兩種后端格式化的實現(xiàn)都有一個致命的缺點，它們在進行時間格式化的時候，都需要對核心業(yè)務類做一定的修改，這就相當為了解決一個問題，又引入了一個新的問題，那有沒有簡單一點、優(yōu)雅一點的解決方案呢？

答案是：有的。我們可以不改任何代碼，只需要在配置文件中設置一下就可以實現(xiàn)時間格式化的功能了。

首先，我們找到SpringBoot的配置文件perties（或application.yml），只需要在perties配置文件中添加以下兩行配置：

格式化全局時間字段

在yml中添加如下配置：

spring.jackson.date-format=yyyy-MM-ddHH:mm:ss

指定時間區(qū)域類型

在yml中添加：

spring.jackson.time-zone=GMT+8

或者下面的格式

spring:

jackson:

##格式為yyyy-MM-ddHH:mm:ss

date-format:yyyy-MM-ddHH:mm:ss

##定時區(qū)，解決8小時的時間差問題

time-zone:GMT+8

這樣設置之后，我們將原始的User和UserController進行還原。

User實現(xiàn)代碼如下：

importlombok.Data;

importjava.util.Date;

@Data

publicclassUser{

privateintid;

privateStringusername;

privateDatecreatetime;

privateDateupdatetime;

}

UserController實現(xiàn)代碼：

@RequestMapping("/list")

publicListUsergetList(){

returnuserMapper.getList();

然后我們運行程序，看到的執(zhí)行結(jié)果如下：

從以上結(jié)果和代碼可以看出，我們只需要在程序中簡單配置一下，就可以實現(xiàn)所有時間字段的格式化了。

實現(xiàn)原理分析

為什么在配置文件中設置一下，就可以實現(xiàn)所有時間字段的格式化了呢？

#格式化全局時間字段

spring.jackson.date-format=yyyy-MM-ddHH:mm:ss

#指定時間區(qū)域類型

spring.jackson.time-zone=GMT+8

這是因為Controller在返回數(shù)據(jù)時，會自動調(diào)用SpringBoot框架中內(nèi)置的JSON框架Jackson，對返回的數(shù)據(jù)進行統(tǒng)一的JSON格式化處理，在處理的過程中它會判斷配置文件中是否設置了spring.jackson.date-format=yyyy-MM-ddHH:mm:ss，如果設置了，那么Jackson框架在對時間類型的字段輸出時就會執(zhí)行時間格式化的處理，這樣我們就通過配置來實現(xiàn)全局時間字段的格式化功能了。

為什么要指定時間區(qū)域類型spring.jackson.time-zone=GMT+8呢？

最現(xiàn)實的原因是，如果我們不指定時間區(qū)域類型，那么查詢出來的時間就會比預期的時間少8個小時，這因為我們（中國）所處的時間區(qū)域比世界時間少8個小時導致的，而當我們設置了時區(qū)之后，我們的時間查詢才會和預期時間保持一致。

GMT是什么？時間區(qū)域設置中的GMT是什么意思？

GreenwichMeanTime(GMT)格林尼治時間，也叫做世界時間。

（下面是格林尼治時間的百度百科，想了解的可以看一下，不想了解的知道是世界時間就行，其他的就是的臀部規(guī)定）

格林尼治時間：格林尼治是英國倫敦南郊原皇家格林尼治天文臺所在地，地球本初子午線的標界處，世界計算時間和經(jīng)度的起點。以其海事歷史、作為本初子午線的標準點、以及格林尼治時間以其命名而聞名于世。這里地勢險要，風景秀麗，兼具歷史和地方風情，也是倫敦在泰晤士河的東方門戶。

不光是天文學家使用格林尼治時間，就是在新聞報刊上也經(jīng)常出現(xiàn)這個名詞。我們知道各地都有各地的地方時間。如果對國際上某一重大事情，用地方時間來記錄，就會感到復雜不便．而且將來日子一長容易搞錯。因此，天文學家就提出一個大家都能接受且又方便的記錄方法，那就是以格林尼治的地方時間為標準。

以本初子午線的平子夜起算的平太陽時。又稱格林尼治平時或格林尼治時間。各地的地方平時與世界時之差等于該地的地理經(jīng)度。1960年以前曾作為基本時間計量系統(tǒng)被廣泛應用。由于地球自轉(zhuǎn)速率曾被認為是均勻的,因此在1960年以前,世界時被認為是一種均勻時。由于地球自轉(zhuǎn)速度變化的影響，它不是一種均勻的時間系統(tǒng)，它與原子時或力學時都沒有任何理論上的關系,只有通過觀測才能對它們進行比較。后來世界時先后被歷書時和原子時所取代，但在日常生活、天文導航、大地測量和宇宙飛行等方面仍屬必需；同時，世界時反映地球自轉(zhuǎn)速率的變化，是地球自轉(zhuǎn)參數(shù)之一，仍為天文學