前后数据交互过程中,Date类型的数据经常会出现类型映射转换的错误,为了达到业务的目标时间格式,通常会使用@JsonFormat 和 @DateTimeFormat,但是这两者有什么区别呢?

福利!福利!本文的衍生篇已发布,感兴趣的伙伴们可以瞅瞅哈,针对 @DateTimeFormat 做了补充说明,有场景示例比较详情,需要的大佬可以看一下。传送门: Spring @DateTimeFormat日期格式化时注解浅析分享

💗💗💗您的点赞、收藏、评论是博主输出优质文章的的动力!!!💗💗💗

欢迎在评论区与博主沟通交流!!!大佬们关注我!种个草不亏!👇🏻 👇🏻 👇🏻

一、示例代码

  • 先准备一个简单POJO,拥有Date类型的成员变量:
@Data
public class DateEntity {
    private Date date;
}
  • lombok依赖(版本任意):
 <dependency>
	  <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>1.18.12</version>
 </dependency>
  • 再准备一个Controller,模拟一下前后交互:
@RestController
@RequestMapping("/date")
public class DateController {

    @RequestMapping("/test")
    public DateEntity getDate(DateEntity dateEntity){
        System.out.println("入参的date:"+dateEntity.getDate());

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String date = sdf.format(dateEntity.getDate());
        System.out.println("SimpleDateFormat格式化后的date:"+date);

        DateEntity result = new DateEntity();
        result.setDate(new Date());
        return result;
     }
}
  • 创建好POJO和Controller后,用Postman模拟一下请求发送:
    在这里插入图片描述
  • 结果报错:
    在这里插入图片描述
  • 大概意思就是说String类型转换成Date类型失败,所以报了IllegalArgumentException异常;

二、@JsonFormat注解

  • 提供者:jackson
  • 作用:可以约束时间的接收格式响应格式 (接收和响应的都是JSON字符串),将日期类型数据在JSON格式和java.util.Date对象之间转换。与传输方向没有关系(前端到后端or后端到前端都可以使用),注意因为我们是东八区(北京时间),使用时需要加上时区( timezone = “GMT+8”),不然所得值会比实际时间晚8小时
  • 常用注解属性:
名称作用
pattern约定时间格式:pattern=“yyyy-MM-dd HH:mm:ss”
timezone指定具体时区: timezone = “GMT+8” or timezone = “Asia/Shanghai”
  • 经过测试使用单独使用@JsonFormat注解时需要先通过@RequestBody将入参参数映射到实体后,@JsonFormat注解才能去对时间格式进行约束;
  • 改造controller,加上了@RequestBody注解:
    @RequestMapping("/test")
    public DateEntity getDate(@RequestBody DateEntity dateEntity){
        System.out.println("入参的date:"+dateEntity.getDate());

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String date = sdf.format(dateEntity.getDate());
        System.out.println("SimpleDateFormat格式化后的date:"+date);

        DateEntity result = new DateEntity();
        result.setDate(new Date());
        return result;
    }
  • POJO类中也加上了@JsonFormat注解:
@Data
public class DateEntity {

    @JsonFormat(pattern = "yyyy-MM-dd hh", timezone = "GMT+8")
    private Date date;
}
  • 测试:
    在这里插入图片描述
  • 结果可以看出,@JsonFormat对时间格式进行了约束 ,mm:ss并没有按传入的值显示:
    在这里插入图片描述
  • 再看return的返回值中也可以看出输出格式是完全按照@JsonFormat约定的时间格式(“yyyy-MM-dd hh”)进行了输出;在这里插入图片描述
  • 实际返回结果:
    在这里插入图片描述

三、@DateTimeFormat注解

  • 提供者:Spring
  • 作用:可对java.util.Date、java.uitl.calendar、java.long.Long及Joda时间类型的属性进行标注,主要处理前端时间类型与后端pojo对象中的成员变量进行数据绑定,所约束的时间格式并不会影响后端返回前端的时间类型数据格式;
  • 注意(注意!注意!注意!讲三遍):前端入参数据的时间格式必须与注解中定义的时间格式相同,不然会报错,如:@DateTimeFormat(pattern = “yyyy-MM-dd HH:mm”) 则入参的格式必须为"2020-6-4 10:43";
  • 常用注解属性:
名称作用
iso类型为DateTimeFormat.ISO,常用值:
DateTimeFormat.ISO.DATE:格式为yyyy-MM-dd
DateTimeFormat.ISO.DATE_TIME:格式为yyyy-MM-dd hh:mm:ss.SSSZ
DateTimeFormat.ISO.TIME:格式为hh:mm:ss.SSSZ
DateTimeFormat.ISO.NONE:表示不使用ISO格式的时间(默认值)
pattern类型为String,使用自定义时间格式化字符串,如"yyyy-MM-dd hh:mm:ss"
style类型为String,通过样式指定日期时间的格式,由两位字符组成,
第一位表示日期的样式,第二位表示时间的格式,以下是几个常用的可选值:
S:短日期/时间的样式
M:中日期/时间的样式
L:短日期/时间的样式
F:完整日期/时间的样子
-:忽略日期或时间的样式
默认值 style=“SS”
  • controller代码:
 @RequestMapping("/test")
    public DateEntity getDate(DateEntity dateEntity){
        System.out.println("入参的date:"+dateEntity.getDate());

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String date = sdf.format(dateEntity.getDate());
        System.out.println("SimpleDateFormat格式化后的date:"+date);

        DateEntity result = new DateEntity();
        Date date1 = new Date();
        result.setDate(date1);
        return result;
    }
  • POJO代码:
@Data
public class DateEntity {

    @DateTimeFormat(pattern = "yyyy-MM-dd hh")
    private Date date;
}
  • 测试:
    -
  • 结果:
    在这里插入图片描述

五、总结 @JsonFormat 和 @DateTimeFormat 区别

  • @JsonFormat 可以约束前端传入的时间类型参数格式可以约束后端响应前端的时间类型格式
  • @DateTimeFormat
    • 只能约束前端入参时间类型的格式,并不会修改原有的日期对象的格式,如果想要获得期望的日期格式,是需要自己手动转换的;
    • 如果单独使用@DateTimeFormat 时,响应给前端的时间会比实际时间晚8个小时(时区原因)。
    • 福利、福利 针对 @DateTimeFormat 做了补充说明,有场景示例比较详情,需要的大佬可以看一下。传送门:Spring @DateTimeFormat日期格式化时注解浅析分享

原创 不易, 感 谢 各 位 大 佬 的 阅 读,随 手 点 赞,日 薪 过 万~! !!
Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐