Go读取MySQL Date类型的避坑指南

 更新时间:2025年12月01日 09:45:23   作者:凉凉的知识库  
文章讨论了在Go中读取MySQL中的DATETIME和DATE类型数据时遇到的格式转换问题,并解释了parseTime参数的作用,并展示了在不同情况下,Go字段类型定义对读取到的时间字符串格式的影响,需要的朋友可以参考下

一不小心就踩坑

先举一个实际的:

我们先创建一个表,并插入一行数据。注意表中两个字段一个是DATETIME类型,一个是DATE类型的

CREATE TABLE `t_test` (
  `id` int NOT NULL AUTO_INCREMENT,
  `f_one` datetime DEFAULT NULL,
  `f_two` date DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

INSERT INTO `test`.`t_test` (`f_one`, `f_two`) VALUES ('2025-11-29 10:25:05', '2025-11-29');

当我们查询数据可以看到和插入的数据一致

  • f_one datetime展示为2025-11-29 10:25:05
  • f_two date展示为2025-11-29
mysql> select * from t_test where id = 1;
+----+---------------------+------------+
| id | f_one               | f_two      |
+----+---------------------+------------+
|  1 | 2025-11-29 10:25:05 | 2025-11-29 |
+----+---------------------+------------+
1 row in set (0.003 sec)

现在使用Go来读取上面的数据

package main

import (
	"testing"

	"github.com/stretchr/testify/assert"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)

type Test struct {
	ID   int    `gorm:"column:id;primaryKey"`
	FOne string `gorm:"column:f_one"` // 注意这里我们定义成了string类型
	FTwo string `gorm:"column:f_two"` // 注意这里我们定义成了string类型
}

func (t Test) TableName() string {
	return "t_test"
}

func TestRead(t *testing.T) {
	// 数据库连接配置
	dsn := "root:root@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=True&loc=Local"

	db, err := gorm.Open(mysql.Open(dsn))
	assert.Nil(t, err)

	var result Test
	err = db.Where("id = ?", 1).Find(&result).Error
	assert.Nil(t, err)

	assert.Equal(t, "2025-11-29 10:25:05", result.FOne)
	assert.Equal(t, "2025-11-29", result.FTwo)
}

可以在这里暂停思考下,上面的单元测试是否会通过。下面是实际执行的结果。

Error: Not equal: 
       expected: "2025-11-29 10:25:05"
       actual  : "2025-11-29T10:25:05+08:00"

Error: Not equal: 
       expected: "2025-11-29"
       actual  : "2025-11-29T00:00:00+08:00"

结果非常Amazing啊

f_one我们期望的是2025-11-29 10:25:05,实际Go读取到是 2025-11-29T10:25:05+08:00,额外添加了T分隔符和时区信息

f_two我们期望的是2025-11-29, 实际Go读取到是 2025-11-29T00:00:00+08:00,不仅额外添加了T分隔符和时区信息,还添加了时分秒

你看,如果你对Go读取到字符串按MySQL时间格式处理,可能一不注意就踩坑里了。

问题出在哪里?

你可能已经注意到了,Go结构体的定义使用了string类型,但不知道你有没有注意到数据库连接中的另外一个参数parseTime=True

parseTime是什么?parseTime是 Go 的 MySQL 驱动 (github.com/go-sql-driver/mysql) 中的一个连接参数,控制是否将 MySQL 时间类型自动转换为 Go 的 time.Time对象:

  • parseTime=false 禁用自动转换(默认值)
  • parseTime=true 启用自动转换

当Go的定义为string类型时,问题就出在自动转换上

parseTime=false时, 转化方式为DATETIME/DATE(MySQL)->string(Go) ,不会出现上面的问题,Go中读取到的字符串和MySQL的格式一致:2025-11-29 10:25:052025-11-29

parseTime=true时,Go的MySQL驱动首先尝试将 MySQL的 DATETIME/DATE(MySQL)解析为 Go 的 time.Time对象,当发现目标字段是 string类型时,驱动会自动调用 time.TimeString()方法进行转换,time.String()按照RFC3339格式输出,与MySQL中展示的格式不一致,就形成了上文的效果。也就是说

# 开启parseTime=true且Go类型定义为string时

`DATETIME(MySQL)` 
      |
      v
`time.Time`(golang) 
      |
      | ->这里的`time.time`到`string`这一步出现了转化差异
      v
`string(golang)`          

总结

下面总结不同parseTime和Go类型定义的情况下,Go程序读取到的值。

Go字段类型定义parseTime=falseparseTime=true
stringYYYY-MM-DD[ HH:MM:SS[.fraction]]
即:
DATE->YYYY-MM-DD
DATETIME->YYYY-MM-DD HH:MM:SS
DATETIME(3)->YYYY-MM-DD HH:MM:SS.sss
DATETIME(6)->YYYY-MM-DD HH:MM:SS.ssssss
零值->0000-00-00[ 00:00:00]

此时Go中时间字符串的格式和MySQL默认格式一致
RFC3339
YYYY-MM-DDTHH:MM:SS±HH:MM

此时Go中时间字符串的格式和MySQL默认格式不一致!!
time.Time报错 (类型不兼容)Gotime.Time实例
如果零值也是零值time.Time实例

由此也引出了比较合理的使用姿势

  • 如果启用了parseTime=true,我建议你在Go中定义成time.Time类型
type Test struct {
	ID   int       `gorm:"column:id;primaryKey"`
	FOne time.Time `gorm:"column:f_one"`
	FTwo time.Time `gorm:"column:f_two"`
}
  • 如果没有启用,即parseTime=false,在Go只能定义成string
type Test struct {
	ID   int    `gorm:"column:id;primaryKey"`
	FOne string `gorm:"column:f_one"`
	FTwo string `gorm:"column:f_two"`
}

到此这篇关于Go读取MySQL Date类型的避坑指南的文章就介绍到这了,更多相关Go读取MySQL Date类型内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Go语言学习之golang-jwt/jwt的教程分享

    Go语言学习之golang-jwt/jwt的教程分享

    jwt是 json web token的简称。go使用jwt目前,主流使用的jwt库是golang-jwt/jwt。本文就来和大家讲讲golang-jwt/jwt的具体使用,需要的可以参考一下
    2023-01-01
  • 成功安装vscode中go的相关插件(详细教程)

    成功安装vscode中go的相关插件(详细教程)

    这篇文章主要介绍了成功安装vscode中go的相关插件的详细教程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-05-05
  • 在Go中使用JSON(附demo)

    在Go中使用JSON(附demo)

    Go开发人员经常需要处理JSON内容,本文主要介绍了在Go中使用JSON,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-02-02
  • Go1.21新增maps包的用法详解

    Go1.21新增maps包的用法详解

    maps 包提供了几个非常有用的用于操作 map 类型(任何类型的 map)的函数,本文为大家整理了部分函数的具体用法,感兴趣的小伙伴可以了解一下
    2023-08-08
  • 使用Go语言启动Redis的实例详解

    使用Go语言启动Redis的实例详解

    这篇文章主要为大家介绍了Go语言中一个可以用来启动 redis-server 的开源库 github.com/stvp/tempredis,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-01-01
  • Go开发Gin项目添加jwt功能实例详解

    Go开发Gin项目添加jwt功能实例详解

    这篇文章主要为大家介绍了Go开发Gin项目中添加jwt功能实例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-07-07
  • Golang错误处理方式异常与error

    Golang错误处理方式异常与error

    我们在使用Golang时,不可避免会遇到异常情况的处理,与Java、Python等语言不同的是,Go中并没有try...catch...这样的语句块,这个时候我们如何才能更好的处理异常呢?本文来教你正确方法
    2023-01-01
  • Go语言中乐观锁与悲观锁的具体使用

    Go语言中乐观锁与悲观锁的具体使用

    乐观锁和悲观锁是两种思想,用于解决并发场景下的数据竞争问题,本文主要介绍了Go语言中乐观锁与悲观锁的具体使用,具有一定的参考价值,感兴趣的可以了解一下
    2024-01-01
  • Go设计模式之空对象模式实战

    Go设计模式之空对象模式实战

    空对计模式是Go语言中一种行为型设计模式,它通过返回实现了相同接口但不执行任何操作的空对象来替代nil值,从而避免因访问nil指针而导致的程序panic,感兴趣的可以了解一下
    2025-09-09
  • Golang 手写一个简单的并发任务 manager

    Golang 手写一个简单的并发任务 manager

    这篇文章主要介绍了Golang 手写一个简单的并发任务 manager,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-08-08

最新评论