Web开发中的时区问题

在国际化的业务场景中，时区问题是常见的。本文将就Web开发中的时区问题进行探索。

关于时区的概念，想必你们都有些了解。咱们的地球被划分为24个时区，北京时间为东八区，而美国的太平洋时间为西八区，和咱们差了16个小时。

下面咱们从一个案例提及，咱们的服务器和数据库部署在北京，而这时美国用户经过浏览器但愿能查询北京时间下的“2020年7月1日8点-2020年7月1日18点”这10个小时的数据。

浏览器上选择时间区域查询数据

为了模拟浏览器在太平洋时间，只需将系统时间设置为太平洋时间便可。而系统时间的改变会影响到JVM的默认时区，因此为了让服务器程序仍处于北京时间，须要经过代码指定时区，以下：

TimeZone.setDefault(TimeZone.getTimeZone("GMT+8"));

而数据库MySQL的时区也设置为北京时间，SQL以下：

set global time_zone = '+8:00';
set time_zone = '+8:00';
flush privileges;

下面，让咱们点击查询，先看下咱们发送的内容：

发送数据的格式

能够看到开始时间和结束时间都比界面上显示的时间多了8小时。这是由于我使用的ElementUI组件的日期时间选择器，其默认时区为0时区，因此会将咱们选择的时间根据浏览器的时区（西八区）转换成0时区的时间。最后传输的内容为时间+时区的字符串表示。

时间-时区的字符串表示

前端把数据成功发出来了，下面咱们看下后端接收数据的状况。后端我使用的是SpringBoot，Controller的代码以下。

@PostMapping("/time")
public List<Data> test(@RequestBody TimeDto dto) {
    Date startTime = dto.getStartTime();
    Date endTime = dto.getEndTime();
    System.out.println(startTime);
    System.out.println(endTime);

    // 格林时间（0）
    String format = "yyyy-MM-dd HH:mm:ss";
    SimpleDateFormat sdfGreen = new SimpleDateFormat(format);
    sdfGreen.setTimeZone(TimeZone.getTimeZone("GMT+0"));
    System.out.println("格林时间：" + sdfGreen.format(startTime) + "至" + sdfGreen.format(endTime));

    // 北京时间（+8）
    SimpleDateFormat sdfBeijing = new SimpleDateFormat(format);
    sdfBeijing.setTimeZone(TimeZone.getTimeZone("GMT+8"));
    System.out.println("北京时间：" + sdfBeijing.format(startTime) + "至" + sdfBeijing.format(endTime));

    // 太平洋时间（-8）
    SimpleDateFormat sdfPacific = new SimpleDateFormat(format);
    sdfPacific.setTimeZone(TimeZone.getTimeZone("GMT-8"));
    System.out.println("太平洋时间：" + sdfPacific.format(startTime) + "至" + sdfPacific.format(endTime));

    List<Data> dataList = queryDate(dto);

    return dataList;
}
/**
Thu Jul 02 00:00:00 GMT+08:00 2020
Thu Jul 02 10:00:00 GMT+08:00 2020
格林时间：2020-07-01 16:00:00至2020-07-02 02:00:00
北京时间：2020-07-02 00:00:00至2020-07-02 10:00:00
太平洋时间：2020-07-01 08:00:00至2020-07-01 18:00:00
**/

因为JVM时区为东八区，因此反序列化时获得的Date对象也是东八区的时间，即2号0点-2号10点。若是咱们直接用startTime和endTime去查询，获得的将是北京时间2号0点到10点的数据，和预想的结果有差别。

时区问题致使的查询时间范围错误

那如何才能查询到北京时间1号8点-1号18点的数据呢。因为咱们前端传输的太平洋时间在后台接收时发生时区转换，因此能够在前端直接传输须要查询的北京时间。也就是1号8点-1号18点。经过设置el-date-picker的value-format属性，指定选择的时间格式“yyyy-MM-dd HH:mm:ss”，这样传输的时间字符串将不具备时区属性。

<el-date-picker
  v-model="dateTimeRange"
  type="datetimerange"
  range-separator="至"
  start-placeholder="开始日期"
  end-placeholder="结束日期"
  value-format="yyyy-MM-dd HH:mm:ss"
  >
</el-date-picker>

修正后的发送数据格式

然后端若是不修改，将报出如下错误，没法将该格式的时间转换成Date对象。

JSON parse error: Cannot deserialize value of type `java.util.Date` from String "2020-07-01 08:00:00": not a valid representation (error: Failed to parse Date value '2020-07-01 08:00:00': Cannot parse date "2020-07-01 08:00:00": while it seems to fit format 'yyyy-MM-dd'T'HH:mm:ss.SSSZ', parsing fails (leniency? null)); nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.util.Date` from String "2020-07-01 08:00:00": not a valid representation (error: Failed to parse Date value '2020-07-01 08:00:00': Cannot parse date "2020-07-01 08:00:00": while it seems to fit format 'yyyy-MM-dd'T'HH:mm:ss.SSSZ', parsing fails (leniency? null))↵ at [Source: (PushbackInputStream); line: 1, column: 14] (through reference chain: com.chaycao.timezone.TimeDto["startTime"])

因此为能正确反序列化，须要为jackjson作反序列化提供额外的信息。加上@JsonFormat注解，指定时区和时间格式，便能达到指望的效果，获得的将是北京时间的1号8点和1号18点。因此，在先后端传输发生的时区问题，注意时间数据的序列化和反序列化方式就能解决。

public class TimeDto {
    @JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm:ss")
    Date startTime;
    @JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm:ss")
    Date endTime;
    //...
}

下面咱们再看下数据库中会发生的时区问题。

咱们将MySQL的时区改成太平洋时间。

set global time_zone = '-8:00';
set time_zone = '-8:00';
flush privileges;

看下查询的结果是否会发生变化，查询的程序以下：

private List<Data> queryDate(TimeDto dto) {
    DriverManagerDataSource dataSource = new DriverManagerDataSource();
    dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
    dataSource.setUrl("jdbc:mysql://localhost/test?useSSL=false&useUnicode=true&characterEncoding=UTF8&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai");
    dataSource.setUsername("root");
    dataSource.setPassword("caoniezi");

    Date startTime = dto.getStartTime();
    Date endTime = dto.getEndTime();

    JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);
    String sql = "SELECT * FROM data WHERE create_time >= ? and create_time <= ?";
    List<Map<String, Object>> maps = jdbcTemplate.queryForList(
        sql,
        new Object[]{startTime, endTime});
    List<Data> dataList = new ArrayList<>();
    for (Map<String, Object> map : maps) {
        Data data = new Data();
        data.setId((Integer) map.get("id"));
        data.setContent((String) map.get("content"));
        data.setCreateTime((Date) map.get("create_time"));
        dataList.add(data);
    }
    return dataList;
}

查询的结果仍然是“D，E，F”，看来数据库时区的改变对于咱们本次查询未产生影响。

修改MySQL时区后查询时间范围正确

这是由于在create_time字段的类型为datetime，而datetime是没有时区概念的，存储的是格式为YYYYMMDDHHMMSS（年月日时分秒）的整数，不会受到时区的影响。
而若是咱们先将时区改回东八区，将create_time的类型改成timestamp，再把时区改成西八区。查询的结果是“H，I，J”。

set global time_zone = '+8:00';
set time_zone = '+8:00';
flush privileges; 

ALTER TABLE `data` MODIFY COLUMN `create_time` TIMESTAMP DEFAULT NULL;

set global time_zone = '-8:00';
set time_zone = '-8:00';
flush privileges;

修改create_time字段类型为timestamp

这是由于timestamp是有时区概念，存入的是自时间纪元以来的秒数，在咱们将类型改成timestamp时，create_time的值也会由东八区计算为0时区的时间秒数存储。当咱们以西八区查询时，会减小16小时。

修改成timestamp后查询

那如何才能在西八区的数据库中查出咱们想要的数据。
jdbc链接url中的serverTimezone参数，其做用是为驱动指定MySQL的时区，在以前的操做中，咱们修改了MySQL的时区，而serverTimezone未修改，仍然是东八区。

jdbc:mysql://localhost/test?useSSL=false&useUnicode=true&characterEncoding=UTF8&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai

查询状况以下，MySQL驱动会根据指定的serverTimezone和JVM时区作转换，因为二者都是东八区，因此startTime和endTime的时间字符串不变，可是因为MySQL时区已变为西八区，查询结果就落到了H、I、J上。

serverTimezone为东八区的查询状况

下面咱们把serverTimezone去掉，在未指定serverTimezone的状况下，驱动会根据MySQL的时区做为serverTimezone，而后作转换，这样获得的结果就是咱们想要的。

serverTimezone不指定的查询状况
可是这样作有一个问题，就是在查询datetime类型的数据时，也会发生转换，查询的结果将是30号16点到1号2点的数据。那么如何才能保证datetime类型、timestamp类型的数据都正确。首先serverTimezone是须要指定Asia/Shanghai的，否则datetime的数据会发生转换。而因为serverTimezone和MySQL时区不一致，查询的timestampe数据存在时区问题，因此最后的办法就是修改MySQL时区为东八区。经过保证MySQL时区、serverTimezone和JVM时区三者一致，来保证时间数据读写的正确性。

文中的代码已上传至Github，感兴趣的同窗能够本身试下：
https://github.com/chaycao/Learn/tree/master/LearnTimeZone