基本介绍

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

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

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

转换示例

示例1,设置loc=Local

配置文件

database:
  link: "mysql:root:12345678@tcp(127.0.0.1:3306)/test?loc=Local"

代码示例

t1, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 10:00:00")
t2, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 11:00:00")
db.Model("user").Ctx(ctx).Where("create_time>? and create_time<?", t1, t2).One()
// 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时区。

t1, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 10:00:00", time.Local)
t2, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 11:00:00", time.Local)
db.Model("user").Ctx(ctx).Where("create_time>? and create_time<?", t1, t2).One()
// 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参数

配置文件

database:
  link: "mysql:root:12345678@tcp(127.0.0.1:3306)/test"

代码示例

t1, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 10:00:00")
t2, _ := time.Parse("2006-01-02 15:04:05", "2020-10-27 11:00:00")
db.Model("user").Ctx(ctx).Where("create_time>? and create_time<?", t1, t2).One()
// 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修改。

t1, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 10:00:00", time.Local)
t2, _ := time.ParseInLocation("2006-01-02 15:04:05", "2020-10-27 11:00:00", time.Local)
db.Model("user").Ctx(ctx).Where("create_time>? and create_time<?", t1, t2).One()
// 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参数时,也需要注意时区转换的问题。

改进建议

建议在配置中统一加上locl配置,例如(MySQL):loc=Local&parseTime=true。以下是一个可供参考的配置:

database:
  logger:
    level:  "all"
    stdout: true
  default:
    link:  "mysql:root:12345678@tcp(192.168.1.10:3306)/mydb?loc=Local&parseTime=true"
    debug: true
  order:
    link:  "mysql:root:12345678@tcp(192.168.1.20:3306)/order?loc=Local&parseTime=true"
    debug: true




Content Menu

  • No labels

8 Comments

  1. 在sqlserver中,如果字段类型是 datetime时,在查询后获取的时间是utc时区的。  可以设置字段类型为 datetime2,这样可以获取的本地时区的时间,这样就可以直接比较时间了

  2. DYL

    请问我需要手动指定新插入数据的created_at和updated_at,这个需要怎么做到呢?我需要用代码导入另外一张表的记录,但是created_at和updated_at字段我想要按原值来进行插入

    1. 写入或者更新数据的时候指定created_atupdated_at,那么ORM不会自动生成时间,而是使用开发者提交的时间。

  3. 设置了时区,只要用命令生成了dao的表,保存时间都会自动变成UTC时间,哪怕存字符串用db.Model().Insert()也一样,新建的没有dao的表就没有这问题

    1. 代码是什么啊,发来看看

      1. 已解决,字段名触发时间维护了

  4. pgsql的时区很奇怪啊,配置中设置的时区是UTC,字段类型是timestamptz,查询没问题,显示的是utc时间。


    但是orm插入时间值会被当成+8时区转换成UTC,但我看debug打印出来的sql语句,时间字符串也没带时区信息啊,理论上数据库应该直接把它当成UTC才对啊。


    框架debug日志:

    ···

    INSERT INTO "user"("username","nickname","password","created_at") VALUES('tttttttt','ttttttt','123456','2024-08-20 21:14:41')

    /* timezone: "UTC"  2024-08-20 21:14:41 入库应该直接就是UTC时间吧,实际到数据库中时间就变成 2024-08-20 13:14:41.621856+00 */

    ···

    是不是 *gtime.Time  对象实际发送到数据库时带有时区信息?日志这边显示的sql语句不是最终执行的?

      


    1. 哎自己搞明白了,打印sql语句是通过 FormatSqlWithArgs 方法实现的,这里面时间格式是手动设置的  `t.Format(`2006-01-02 15:04:05`)`  ,而最终执行sql是传的 time.Time对象给标准库 database/sql ,最终time.Time.String() 方法是带时区信息的