Web 时区
    在国际化的业务场景中,时区问题是常见的。
    关于时区的概念,地球被划分为24个时区,北京时间为东八区,而美国的太平洋时间为西八区,和我们差了16个小时。
    下面从一个案例说起,服务器和数据库部署在北京,而这时美国用户通过浏览器希望能查询北京时间下的“2020年7月1日8点-2020年7月1日18点”这10个小时的数据。
    Web开发中的时区问题 - 图1
    浏览器上选择时间区域查询数据
    为了模拟浏览器在太平洋时间,只需将系统时间设置为太平洋时间即可。而系统时间的改变会影响到JVM的默认时区,所以为了让服务器程序仍处于北京时间,需要通过代码指定时区,如下:

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

    而数据库MySQL的时区也设置为北京时间,SQL如下:

    1. set global time_zone = '+8:00';
    2. set time_zone = '+8:00';
    3. flush privileges;

    下面,让点击查询,先看下发送的内容:
    image.png
    发送数据的格式
    可以看到开始时间和结束时间都比界面上显示的时间多了8小时。这是因为使用的ElementUI组件的日期时间选择器,其默认时区为0时区,所以会将选择的时间根据浏览器的时区(西八区)转换成0时区的时间。最后传输的内容为时间+时区的字符串表示。
    Web开发中的时区问题 - 图3时间-时区的字符串表示
    前端把数据成功发出来了,下面看下后端接收数据的情况。后端使用的是SpringBoot,Controller的代码如下。

    1. @PostMapping("/time")
    2. public List<Data> test(@RequestBody TimeDto dto) {
    3. Date startTime = dto.getStartTime();
    4. Date endTime = dto.getEndTime();
    5. System.out.println(startTime);
    6. System.out.println(endTime);
    7. // 格林时间(0)
    8. String format = "yyyy-MM-dd HH:mm:ss";
    9. SimpleDateFormat sdfGreen = new SimpleDateFormat(format);
    10. sdfGreen.setTimeZone(TimeZone.getTimeZone("GMT+0"));
    11. System.out.println("格林时间:" + sdfGreen.format(startTime) + "至" + sdfGreen.format(endTime));
    12. // 北京时间(+8)
    13. SimpleDateFormat sdfBeijing = new SimpleDateFormat(format);
    14. sdfBeijing.setTimeZone(TimeZone.getTimeZone("GMT+8"));
    15. System.out.println("北京时间:" + sdfBeijing.format(startTime) + "至" + sdfBeijing.format(endTime));
    16. // 太平洋时间(-8)
    17. SimpleDateFormat sdfPacific = new SimpleDateFormat(format);
    18. sdfPacific.setTimeZone(TimeZone.getTimeZone("GMT-8"));
    19. System.out.println("太平洋时间:" + sdfPacific.format(startTime) + "至" + sdfPacific.format(endTime));
    20. List<Data> dataList = queryDate(dto);
    21. return dataList;
    22. }
    23. /**
    24. Thu Jul 02 00:00:00 GMT+08:00 2020
    25. Thu Jul 02 10:00:00 GMT+08:00 2020
    26. 格林时间:2020-07-01 16:00:00至2020-07-02 02:00:00
    27. 北京时间:2020-07-02 00:00:00至2020-07-02 10:00:00
    28. 太平洋时间:2020-07-01 08:00:00至2020-07-01 18:00:00
    29. **/

    由于JVM时区为东八区,所以反序列化时得到的Date对象也是东八区的时间,即2号0点-2号10点。如果直接用startTime和endTime去查询,得到的将是北京时间2号0点到10点的数据,和预想的结果有差异。
    Web开发中的时区问题 - 图4时区问题导致的查询时间范围错误
    那如何才能查询到北京时间1号8点-1号18点的数据呢。由于前端传输的太平洋时间在后台接收时发生时区转换,所以可以在前端直接传输需要查询的北京时间。也就是1号8点-1号18点。通过设置el-date-pickervalue-format属性,指定选择的时间格式“yyyy-MM-dd HH:mm:ss”,这样传输的时间字符串将不具有时区属性。

    1. <el-date-picker
    2. v-model="dateTimeRange"
    3. type="datetimerange"
    4. range-separator="至"
    5. start-placeholder="开始日期"
    6. end-placeholder="结束日期"
    7. value-format="yyyy-MM-dd HH:mm:ss"
    8. >
    9. </el-date-picker>

    Web开发中的时区问题 - 图5
    修正后的发送数据格式
    而后端如果不修改,将报出以下错误,无法将该格式的时间转换成Date对象。

    1. 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点。所以,在前后端传输发生的时区问题,注意时间数据的序列化和反序列化方式就能解决。

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

    下面再看下数据库中会发生的时区问题。
    将MySQL的时区改为太平洋时间。

    1. set global time_zone = '-8:00';
    2. set time_zone = '-8:00';
    3. flush privileges;

    看下查询的结果是否会发生变化,查询的程序如下:

    1. private List<Data> queryDate(TimeDto dto) {
    2. DriverManagerDataSource dataSource = new DriverManagerDataSource();
    3. dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
    4. dataSource.setUrl("jdbc:mysql://localhost/test?useSSL=false&useUnicode=true&characterEncoding=UTF8&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai");
    5. dataSource.setUsername("root");
    6. dataSource.setPassword("caoniezi");
    7. Date startTime = dto.getStartTime();
    8. Date endTime = dto.getEndTime();
    9. JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);
    10. String sql = "SELECT * FROM data WHERE create_time >= ? and create_time <= ?";
    11. List<Map<String, Object>> maps = jdbcTemplate.queryForList(
    12. sql,
    13. new Object[]{startTime, endTime});
    14. List<Data> dataList = new ArrayList<>();
    15. for (Map<String, Object> map : maps) {
    16. Data data = new Data();
    17. data.setId((Integer) map.get("id"));
    18. data.setContent((String) map.get("content"));
    19. data.setCreateTime((Date) map.get("create_time"));
    20. dataList.add(data);
    21. }
    22. return dataList;
    23. }

    查询的结果仍然是“D,E,F”,看来数据库时区的改变对于本次查询未产生影响。
    Web开发中的时区问题 - 图6修改MySQL时区后查询时间范围正确
    这是因为在create_time字段的类型为datetime,而datetime是没有时区概念的,存储的是格式为YYYYMMDDHHMMSS(年月日时分秒)的整数,不会受到时区的影响。
    而如果先将时区改回东八区,将create_time的类型改为timestamp,再把时区改为西八区。查询的结果是“H,I,J”。

    1. set global time_zone = '+8:00';
    2. set time_zone = '+8:00';
    3. flush privileges;
    4. ALTER TABLE `data` MODIFY COLUMN `create_time` TIMESTAMP DEFAULT NULL;
    5. set global time_zone = '-8:00';
    6. set time_zone = '-8:00';
    7. flush privileges;

    image.png
    修改create_time字段类型为timestamp
    这是因为timestamp是有时区概念,存入的是自时间纪元以来的秒数,将类型改为timestamp时,create_time的值也会由东八区计算为0时区的时间秒数存储。当以西八区查询时,会减少16小时。
    Web开发中的时区问题 - 图8修改为timestamp后查询
    那如何才能在西八区的数据库中查出想要的数据。
    jdbc连接url中的serverTimezone参数,其作用是为驱动指定MySQL的时区,在之前的操作中,修改了MySQL的时区,而serverTimezone未修改,仍然是东八区。

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

    查询情况如下,MySQL驱动会根据指定的serverTimezone和JVM时区做转换,由于两者都是东八区,所以startTime和endTime的时间字符串不变,但是由于MySQL时区已变为西八区,查询结果就落到了H、I、J上。
    Web开发中的时区问题 - 图9serverTimezone为东八区的查询情况
    下面把serverTimezone去掉,在未指定serverTimezone的情况下,驱动会根据MySQL的时区作为serverTimezone,然后做转换,这样得到的结果就是想要的。
    Web开发中的时区问题 - 图10serverTimezone不指定的查询情况
    但是这样做有一个问题,就是在查询datetime类型的数据时,也会发生转换,查询的结果将是30号16点到1号2点的数据。那么如何才能保证datetime类型、timestamp类型的数据都正确。首先serverTimezone是需要指定Asia/Shanghai的,不然datetime的数据会发生转换。而由于serverTimezone和MySQL时区不一致,查询的timestampe数据存在时区问题,所以最后的办法就是修改MySQL时区为东八区。通过保证MySQL时区、serverTimezone和JVM时区三者一致,来保证时间数据读写的正确性