基本介绍

这个问题由于大家问得比较多,因此单独开了一个章节详细介绍一下ORM中的时区处理是怎么一回事。我们这里以MySQL数据库为基础来介绍时区转换的事情,本地时区我们设定为+8时区,数据库时区也是+8时区。

MySQL数据库驱动用得最多的是这个第三方包:https://github.com/go-sql-driver/mysql ,在这个第三方包中有这么一个参数:

ORM时区处理 - 图1

大概的意思是,当你提交的时间参数为time.Time时,该参数用来转换参数时区的。当你在连接数据库时,该参数传递loc=Local,那么该driver将会自动将你提交的time.Time参数转换为本地程序设置的时区,没有手动设置时,那么该时区为UTC时区。那么我们来看两个例子。

转换示例

示例1,设置loc=Local

配置文件

  1. [database]
  2. link = "mysql:root:12345678@tcp(127.0.0.1:3306)/test?loc=Local"

代码示例

  1. t1, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 10:00:00")
  2. t2, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 11:00:00")
  3. db.Model("user").Where("create_time>? and create_time<?", t1, t2).One()
  4. // SELECT * FROM `user` WHERE create_time>'2020-10-27 18:00:00' AND create_time<'2020-10-27 19:00:00'

这里由于通过time.Parse创建的time.Time时间对象是UTC时区,那么提交到数据库执行时将会被底层的driver修改为+8时区。

  1. t1, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 10:00:00", time.Local)
  2. t2, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 11:00:00", time.Local)
  3. db.Model("user").Where("create_time>? and create_time<?", t1, t2).One()
  4. // SELECT * FROM `user` WHERE create_time>'2020-10-27 10:00:00' AND create_time<'2020-10-27 11:00:00'

这里由于通过time.ParseInLocation创建的time.Time时间对象是+8时区,和loc=Local的时区一致,那么提交到数据库执行时不会被底层的driver修改。

注意在写入数据中包含time.Time参数时,也需要注意时区转换的问题。

示例2,不设置loc参数

配置文件

  1. [database]
  2. link = "mysql:root:12345678@tcp(127.0.0.1:3306)/test"

代码示例

  1. t1, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 10:00:00")
  2. t2, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 11:00:00")
  3. db.Model("user").Where("create_time>? and create_time<?", t1, t2).One()
  4. // SELECT * FROM `user` WHERE create_time>'2020-10-27 10:00:00' AND create_time<'2020-10-27 11:00:00'

这里由于通过time.Parse创建的time.Time时间对象是UTC时区,那么提交到数据库执行时将不会被底层的driver修改。

  1. t1, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 10:00:00", time.Local)
  2. t2, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 11:00:00", time.Local)
  3. db.Model("user").Where("create_time>? and create_time<?", t1, t2).One()
  4. // SELECT * FROM `user` WHERE create_time>'2020-10-27 02:00:00' AND create_time<'2020-10-27 03:00:00'

这里由于通过time.ParseInLocation创建的time.Time时间对象是+8时区,那么提交到数据库执行时会被底层的driver修改为UTC时区。

注意在写入数据中包含time.Time参数时,也需要注意时区转换的问题。

改进方案

也就是说,当你使用time.Time对象作为时间参数时,无论如何你都会需要注意时区自动转换的问题。因此,为了避免这样的心智负担,防止大家踩坑,在保留对time.Time参数支持的同时,ORM增加了对gtime.Time类型参数的支持,该类型不会涉及到时区转换困惑的问题。例如:

  1. t1 := gtime.New("2020-10-27 10:00:00")
  2. t2 := gtime.New("2020-10-27 11:00:00")
  3. db.Model("user").Where("create_time>? and create_time<?", t1, t2).One()
  4. // SELECT * FROM `user` WHERE create_time>'2020-10-27 10:00:00' AND create_time<'2020-10-27 11:00:00'

即,你传递什么时间参数,那么提交到数据库执行的也是同样的时间参数,不会执行任何的时区转换,免去了心智负担。

这也是为什么goframe框架cli开发工具自动生成的model代码文件中涉及到时间类型的属性均使用了*gtime.Time类型而不是time.Time的缘故。

此外,还需要说明的是,goframe框架的ORM默认情况下没有设置loc参数,可以通过Timezone参数配置。