前言
🍊缘由
用@JsonFormat(pattern = "yyyy-MM-dd")注解,出生日期竟然年轻了一天
艺术源于生活,bug源于开发。
起因是艰苦奋战一个月,测试及验收都顺利通过,上线也稳稳的成功。但是毒奶总是在不经意给你灌上,部分的用户的身份证和出生日期对不上,总是少一天。
开始以为前端显示转化错误,但是发现是后台接口给到前端就已经错了;又怀疑数据库存储有问题,但又惨遭打脸,数据库对得很;又排查接口逻辑均没问题,挠头的同时发现了@JsonFormat(pattern = "yyyy-MM-dd") 这个注解,百度了一下最终发现问题出在【夏令时】这玩意上,特来跟大家分享下解决方案。
🎯主要目标
实现3大重点
1. 了解什么是夏令时
2. @JsonFormat注解详解
3. 解决夏令时问题方案
正文
🍵夏令时
夏令时,(Daylight Saving Time:DST),也叫夏时制,又称“日光节约时制”和“夏令时间”,是一种为节约能源而人为规定地方时间的制度,在这一制度实行期间所采用的统一时间称为“夏令时间”。一般在天亮早的夏季人为将时间调快一小时,可以使人早起早睡,减少照明量,以充分利用光照资源,从而节约照明用电。各个采纳夏时制的国家具体规定不同,全世界有近110个国家每年要实行夏令时。
1986年4月,中国中央有关部门发出“在全国范围内实行夏时制的通知”,具体做法是:每年从四月中旬第一个星期日的凌晨2时整(北京时间),将时钟拨快一小时,即将表针由2时拨至3时,夏令时开始;到九月中旬第一个星期日的凌晨2时整(北京夏令时),再将时钟拨回一小时,即将表针由2时拨至1时,夏令时结束。从1986年到1991年的六个年度,除1986年因是实行夏时制的第一年,从5月4日开始到9月14日结束外,其它年份均按规定的时段施行。在夏令时开始和结束前几天,新闻媒体均刊登有关部门的通告。1992年起,夏令时暂停实行。
🎯总结来说:在1986年到1991年,时间调快了一小时。举个实际的例子来说,一个人的生日为
1991年5月2日0点10分出生,那么使用@JsonFormat就相当于减去一小时变成1991年5月1日23点10分,比实际生日小了一天。
🐠注解@JsonFormat(pattern = “yyyy-MM-dd“)
@JsonFormat用来表示json序列化的一种格式或者类型
@JsonFormat(
pattern = "yyyy-MM-dd"
)
private Date birthTime;
🎯代码解释:将数据库birthTime这个字段date类型值转化成这个yyyy-MM-dd格式,如1993-05-14 00:00:00 转化为1993-05-14
🥎 解决方案
1. @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8" )
GMT(Greenwich Mean Time):格林尼治标准时间。
北京时间使用东八区时间,即GMT加8个小时就是北京时间。
/**
* 出生日期.
*/
@ApiModelProperty("出生日期")
@JsonFormat(
pattern = "yyyy-MM-dd",
timezone = "GMT+8"
)
private Date birthTime;
2. 启动时JVM加入参数 -Duser.timezone=GMT+08
3. @JsonFormat(pattern = "yyyy-MM-dd", locale = "zh", timezone = "Asia/Shanghai")
/**
* 出生日期.
*/
@ApiModelProperty("出生日期")
@JsonFormat(pattern = "yyyy-MM-dd", locale = "zh", timezone = "Asia/Shanghai")
private Date birthTime;
总结
本文通过实际项目遇到的夏令时小bug作为延伸,详解了@JsonFormat注解及如何解决夏令时的问题,解决方案分别是原注解中加入timezone = "GMT+8",或者启动时修改jvm参数,及采用替换注解方式来平替此注解产生的问题,希望能帮助到碰到此问题蒙圈的博友。