java joda 获取utc时间_[原创]Java项目统一UTC时间方案

Java项目统一UTC时间方案

作者：Gods_巨蚁

引言

近期团队的个别项目在进行框架升级后，部分时间值存在8小时误差，原因是错误的将数据库中的时间数据理解成了UTC时间(旧版本认为是北京时间)

考虑到未来项目对于时间理解的一致性，我决定将项目统一为使用UTC时间，经调研，形成本文

mysql数据库时区及时间时间类型说明

数据库时区

mysql数据库拥有时区设置，默认使用系统时区

可通过如下语句查询当前时区

show variables like '%time_zone%';

下图为我个人机器上mysql数据库时区设置：

项目线上数据库时区设置如下:

可见数据库使用系统时间CST——China Standard Time UTC+8:00 中国沿海时间(北京时间)

时间类型说明

datetime

实际格式储存(Just stores what you have stored and retrieves the same thing which you have stored.)

与时区无关(It has nothing to deal with the TIMEZONE and Conversion.)

timestamp

值以UTC毫秒数保存( it stores the number of milliseconds)

存储及检索时根据当前时区设置，对时间数值做转换

由于timestamp与时区相关，且线上数据库时区设置为北京时间(即UTC+8:00)。因此，当数据库中使用了timestamp列，若使用不当，统一UTC格式时间改造将很可能会引入错误！ 后面详述理由

统一UTC时间改造方案简述

统一时区设定

项目新框架中通过UTCTimeZoneConfiguration类型，在项目初始化时设置当前进程的默认时区

@Configuration

public class UTCTimeZoneConfiguration implements ServletContextListener{

public void contextInitialized(ServletContextEvent event) {

System.setProperty("user.timezone", "UTC");

TimeZone.setDefault(TimeZone.getTimeZone("UTC"));

}

public void contextDestroyed(ServletContextEvent event) {}

}

时间类型Joda DateTime的使用方式

日期时间类型可以使用 java.util.Date，但推荐使用更为方便的joda DateTime，本节介绍joda DateTime 序列化/反序列化使用方式

Joda DateTime 类型用于定义接口输入输出参数，需进行序列化/反序列化操作。与原生的Date类型不同，DateTime需要做一点额外处理

1、Model类型的日期字段使用类型DateTime替代Date

实例代码如下

public class Entity {

@JsonSerialize(using = UTCDateTimeSerializer.class)

@JsonDeserialize(using = UTCDateTimeDeserializer.class)

private DateTime dateTime;

public DateTime getDateTime() {

return dateTime;

}

public void setDateTime(DateTime dateTime) {

this.dateTime = dateTime;

}

}

其中UTCDateTimeSerializer与UTCDateTimeDeserializer类的实现见附录

2、Get请求接受时间参数

此时，一种有效的处理方式是使用字符串接受日期参数，如下：

@RequestMapping(value = "/xxx", method = RequestMethod.GET)

public CommonResponse getXxx(@RequestParam(value = "beginTime") String beginTimeText,

@RequestParam(value = "endTime") String endTimeText) {

DateTime beginTime = DateTime.parse(beginTimeText).withZone(DateTimeZone.UTC);

DateTime endTime = DateTime.parse(endTimeText).withZone(DateTimeZone.UTC);

...

}

Dao时间操作——针对数据库列为datetime的场景

以Joda DateTime类型举例说明使用方法，某Dao类型中存在的两个方法如下：

public void update(int id, DateTime dateTime) {

String sql = "UPDATE " + TABLE_NAME + " SET datetime = ? WHERE id = ?";

jdbcTemplate.update(sql, new Timestamp(dateTime.getMillis()), id);

}

public DateTime getDateTime(int id) {

String sql = "SELECT datetime FROM " + TABLE_NAME + " WHERE id = ?";

List dateTimeList = jdbcTemplate.query(sql, new Object[] {id}, new RowMapper() {

@Override

public DateTime mapRow(ResultSet rs, int rowNum) throws SQLException {

return new DateTime(rs.getTimestamp("datetime").getTime());

}

});

return dateTimeList.size() > 0 ? dateTimeList.get(0) : null;

}

插入或更新数据，传递的时间参数请使用 new Timestamp(dateTime.getMillis())

读取时间参数，使用new DateTime(rs.getTimestamp("datetime").getTime())

Dao时间操作——针对数据库列为timestamp的场景

数据库timestamp类型适合用来记录数据的最后修改时间

其他场景建议使用datetime或者int

方案一更改会话时区为UTC时间

对timestamp列的操作与datetime列的操作不做区分，此时需要设置数据连接会话的时区，默认为北京时间，需要设置为UTC时间，通过如下语句设置

set time_zone = '+0:00';

实际项目中使用数据库连接池，创建datasource后使用如下方式设置时区，将对所有连接生效

dataSource.setInitSQL("set time_zone = '+0:00'");

经此操作后，时区统一为UTC时间，Dao中时间操作，无需对timestamp做特殊处理

方案二不更改会话时区

由于不更改时区，timestamp类型数据的使用存在一定限制

1、如何更新timestamp数据

对于数据库表中的timestamp列，其值的更新应当由数据库自行维护，在create table时设置，如下：

CREATE TABLE t1 (

ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP

);

可简写如下

CREATE TABLE t1 (

ts TIMESTAMP

);

不允许程序自主更新timstamp列数据

线上数据库时区为北京时间，其接受到的日期数据被视为北京时间，而上层程序业务逻辑统一使用UTC时间，时区不统一。因此避免数据库记录的日期数据理解不一致，不允许程序通过写操作sql语句更新timestamp列

下图数据为本人实测数据，timestamp列由程序进行更新，update_time列则由数据库自动更新

前者显示的是UTC时间，看似合理，实则错误，数据库内部存储时间为UTC-8:00

update_time符合数据库时区设置，返回北京时间，内部实际存储UTC时间

2、如何读取timestamp数据

为避免从数据库中获取时区相关时间(北京时间)，强制使用UTC时间，使用函数UNIX_TIMESTAMP获取1970年至今秒数，转换成DateTime时乘以1000转变为毫秒

public DateTime getTimestamp(int id) {

String sql = "SELECT UNIX_TIMESTAMP(update_time) as unix_timestamp FROM " + TABLE_NAME + " WHERE id = ?";

List dateTimeList = jdbcTemplate.query(sql, new Object[] {id}, new RowMapper() {

@Override

public DateTime mapRow(ResultSet rs, int rowNum) throws SQLException {

return new DateTime(rs.getLong("unix_timestamp") * 1000);

}

});

return dateTimeList.size() > 0 ? dateTimeList.get(0) : null;

}

附录

Mysql时区设置

设置全局时区，需要管理员权限

使用本机系统时区

SET GLOBAL time_zone = SYSTEM;

使用UTC时间

SET GLOBAL time_zone = '+0:00';

使用北京时间

SET GLOBAL time_zone = '+8:00';

设置当前连接会话时区

set time_zone = '+0:00';

UTCDateTimeSerializer与UTCDateTimeDeserializer

UTCDateTimeSerializer 完成DateTime对象到UTC时间字符串的转换，格式为：yyyy-MM-ddTHH:mm:ssZ

UTCDateTimeDeserializer 完成时间字符串到DateTime对象的转换，转换为UTC时区

具体实现如下：

public class UTCDateTimeSerializer extends JsonSerializer {

@Override

public void serialize(DateTime dateTime,

JsonGenerator jsonGenerator,

SerializerProvider provider) throws IOException {

String dateTimeAsString = dateTime.withZone(DateTimeZone.UTC).toString(BecConstant.DATETIME_FORMAT);

jsonGenerator.writeString(dateTimeAsString);

}

}

public class UTCDateTimeDeserializer extends JsonDeserializer {

@Override

public DateTime deserialize(JsonParser jsonParser, DeserializationContext deserializationContext)

throws IOException {

JsonToken currentToken = jsonParser.getCurrentToken();

if (currentToken == JsonToken.VALUE_STRING) {

String dateTimeAsString = jsonParser.getText().trim();

return DateTime.parse(dateTimeAsString).withZone(DateTimeZone.UTC);

}

return null;

}

}

Java springmvc 统一异常处理的方案

前言:为什么要统一异常处理?经常在项目中需要统一处理异常,将异常封装转给前端.也有时需要在项目中统一处理异常后,记录异常日志,做一下统一处理. Springmvc 异常统一处理的方式有三种. 一.使用 ...

Java local 转UTC时间

import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Calendar; impor ...

Java UTC时间与本地时间互相转换

协调世界时,又称世界统一时间.世界标准时间.国际协调时间.由于英文(CUT)和法文(TUC)的缩写不同,作为妥协,简称UTC. 这套时间系统被应用于许多互联网和万维网的标准中,例如,网络时间协议就是协 ...

Java 项目创建 -- 统一结果处理、统一异常处理、统一日志处理

一.IDEA 插件使用 1.说明 此处使用 SpringBoot 2.2.6 .JDK 1.8 .mysql 8.0.18 作为演示. 使用 IDEA 作为开发工具. 2.IDEA 插件 -- Lom ...

Java中转UTC时间字符串(含有T Z)为local时间

在Java中我们需要转换相应格式的字符串,很多时候我们想到用SimpleDateFormat类来解析.但是最近我在调用一个第三方的接口时返回的 JSON字符串中有个expires字段的值是2014-0 ...

Java获得UTC时间

在Java语言中,您可以通过java.util.Calendar类取得一个本地时间或者指定时区的时间实例,如下: 取得本地时间: java.util.Calendar cal = java.util. ...

Java微服务对UTC时间格式的处理

一.背景 先说一下为什么要使用UTC时间.开发一个全球化的系统,服务端(Java微服务)集中部署在同一个地方,用户在全球通过浏览器.手机客户端访问.不同地区的时区是不一样的,同一个时间戳,不同的用户看 ...

传统Java Web(非Spring Boot)、非Java语言项目接入Spring Cloud方案

技术架构在向spring Cloud转型时,一定会有一些年代较久远的项目,代码已变成天书,这时就希望能在不大规模重构的前提下将这些传统应用接入到Spring Cloud架构体系中作为一个服务以供其它项 ...

java UTC时间和local时间相互转换

java UTC时间和local时间相互转换 1.local时间转UTC时间 /** * local时间转换成UTC时间 * @param localTime * @return */ public ...

随机推荐

mybaties # , $

mybaties会对#引入的值加上双引号, 如: #{buildingName} -------->"buildingName";mybaties会将$引入的值直接显示到sq ...

JVM 1.类的加载、连接、初始化

Java类的加载是由类加载器来完成的,过程如下: 首先,加载是把硬盘.网络.数据库等的class文件中的二进制数据加载到内存的过程,然后会在Java虚拟机的运行时数据区的堆区创建一个Class对象,用 ...

UBUNTU 下如何升级 gcc, g++

正如大家所知道的GCC并不支持"make uninstall". 一种推荐安装方式就是把GCC 安装在你自己指定的一个路径,当你不须要某个GCC版本号的时候你仅仅须要移除相应版本号 ...

硬盘安装Archlinux「2013-12-26」

按照Archlinux的中文WIKI安装完成,最后安装引导失败.原因未知. 折腾的脑袋好大,本来都要放弃了,幸好在贴吧发帖求助,吧友@atmouse耐心热心的帮助 最后重启成功启动.帖子地址:http ...

cuda编程(一)

环境安装和例程运行 显卡主要有两家,ATI.NVIDIA,简称A卡和N卡.随着GPU计算能力的上升,采用GPU并行计算来加速的应用越来越多. Nvidia创立人之一,黄仁勋(Jen-Hsun Huan ...

单源最短路Dijkstra算法——matlab实现

迪杰斯特拉(Dijkstra)算法是典型最短路径算法,用于计算一个节点到其他节点的最短路径. 它的主要特点是以起始点为中心向外层层扩展(广度优先搜索思想),直到扩展到终点为止. 基本思想 通过Dijk ...

Docker 镜像小结 - 每天5分钟玩转 Docker 容器技术(21)

本节我们对 Docker 镜像做个小结. 这一部分我们首先讨论了镜像的分层结构,然后学习了如何构建镜像,最后实践使用 Docker Hub 和本地 registry. 下面是镜像的常用操作子命令: i ...

PHP随机生成要求位数个字符(大小写字母+数字)

php随机生成要求位数个字符 /** * 随机生成要求位数个字符 * @param length 规定几位字符 */ function getRandChar($length){ $str = nul ...

MySql利用mysqldump导出/导入数据库表数据

备份 在源主机上,先使用mysqldump命令备份,导出sql脚本文件 mysqldump -uroot -p tel_dev > /opt/tel_dev.sql 也可指定编码 mysqldu ...

配置海康相机SDK文件

前言 项目使用到海康摄像机,进行二次开发需要首先对SDK文件进行相关配置. 实现过程 1.下载SDK开发包: 网址:http://www.hikvision.com/cn/download_61.ht ...