关于 @DateTimeFormat 和 @JsonFormat 的区别以及springboot接口传Date的时候如何传参(dateformat)

有目标就不怕路远。年轻人.无论你现在身在何方.重要的是你将要向何处去。只有明确的目标才能助你成功。没有目标的航船.任何方向的风对他来说都是逆风。因此,再遥远的旅程,只要有目标.就不怕路远。没有目标,哪来的劲头?一车尔尼雷夫斯基

导读:本篇文章讲解 关于 @DateTimeFormat 和 @JsonFormat 的区别以及springboot接口传Date的时候如何传参(dateformat),希望对大家有帮助,欢迎收藏,转发!站点地址:www.bmabk.com,来源:原文

背景

你真的用对了 @DateTimeFormat@JsonFormat 吗? 相信90%的人都搞不清楚它们的区别以及本文提到的细节

本文基于 springboot 2.3.7.RELEASE 版本

结论

可以花两分钟看看结论,其他有时间选看。

  • 传非 JSON (比如键值对 x-www-form-urlencoded 或 form-data)

    得使用 @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss"),否则无法转换,具体的格式可以自行修改

    传非JSON包括:

    1、Date 字段直接作为rest接口参数

    2、Date字段放在一个类里头作为rest接口的入参

  • 传 JSON,不能用 @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss") !!! 得用 @JsonFormat(pattern="yyyy-MM-dd HH:mm:ss") 一般不要写上 timezone="GMT+8"

    • 也就是说 @JsonFormat 既将出参Date转为String,也将入参String转为Date,是双向的、两用的,以前我只知道 “出参的时候才用@JsonFormat”

    • 关于要不要设置 @JsonFormat 的时区:@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")

      我个人建议应该不要。
      
      作为入参的时候,你将字串格式化成+8时区了,万一你的应用程序不在+8时区部署的呢,就有问题了。
      
      作为出参,面临同样的问题,将 Date 转为固定的某个时区的字串,明显感觉不太妥当。你的应用如果是全球性的,展示时间时,字串展示为带时区的会比较好,比如:2021-10-15 11:30[ (UTC+08:00)Beijing ]  吐槽:当前,跟多的应用在展示的时间字串看不出时区,比如2021-10-15 11:30。
      

PS:DateTimeFormat 是没有时区的设置的,而 JsonFormat 有!

详细研究过程

1、传 Date 方式一

直接让 Date 作为 rest 接口的参数 (传键值对 x-www-form-urlencoded)

@RequestMapping("/date1")
public ResponseDTO date1(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") Date date) {// 必须使用 @DateTimeFormat 才能实现转换
    return ResponseDTO.succ(date);
}
  • 必须加 @DateTimeFormat 才能实现转换

  • 格式要严格遵守 pattern

    例如 yyyy-MM-dd HH:mm:ss 则不能只有日期部分,也不能去掉秒,也不能将 - 换成 /
    
  • 改成用 @JsonFormat 不行!!

2、传 Date 方式二

rest 接口使用一个类,类里面含 Date 字段,传的还是键值对 (x-www-form-urlencoded)

@RequestMapping("/date2")
public ResponseDTO date2(DateKvDTO dateDTO) {// 里面的 Date 字段必须用 @DateTimeFormat
    return ResponseDTO.succ(dateDTO);
}

@Data
public class DateKvDTO {
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date date;
}
  • 必须在入参类的 Date 字段加 @DateTimeFormat 才能实现转换

  • 格式要严格遵守 pattern

  • 改成用 @JsonFormat 不行!!

3、传 Date 方式三

rest 接口使用传 JSON 方式 (application/json)

@PostMapping("/date3")
public ResponseDTO date3(@RequestBody DateJsonDTO jsonDTO) {
    return ResponseDTO.succ(jsonDTO);
}

@Data
public class DateJsonDTO {
    private Date date;
}
  • date 可以不设置 @DateTimeFormat 也能顺利转换,但要符合一定的格式

    springboot 旧版可以使用 `yyyy-MM-dd HH:mm:ss`,新版的格式稍微不同,要用 `yyyy-MM-ddTHH:mm:ss` (中间有个T隔开日期和时间)
    
  • **对于传 JSON 的情况,使用 @DateTimeFormat 是没有用的,这个注解不起作用!!!**得用 @JsonFormat 才能生效!!!

  • 最佳实践是 Date 类型也加上 @JsonFormat 以便控制前端给我们的格式

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之家整理,本文链接:https://www.bmabk.com/index.php/post/135151.html

(0)
飞熊的头像飞熊bm

相关推荐

发表回复

登录后才能评论
极客之家——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!