本教程详细讲解如何在go语言中将`time.time`对象或`int64`时间戳格式化为常见的`yyyy-mm-dd hh:mm:ss`字符串，类似于mysql的rfc3339标准。文章将深入探讨go时间格式化的核心机制，纠正常见错误，并提供清晰的代码示例，帮助开发者准确有效地处理时间显示需求。
在Go语言中处理日期和时间格式化是常见的需求，尤其是在与数据库交互时，例如将Go的时间对象输出为MySQL数据库中常见的YYYY-MM-DD HH:MM:SS格式。Go语言采用一种独特且强大的方式来定义时间格式，即通过一个特定的参考时间来构建格式字符串。
Go语言时间格式化基础
Go语言中的time.Format()方法不使用传统的格式化占位符（如%Y, %m等），而是通过一个固定的参考时间点Mon Jan 2 15:04:05 MST 2006（或者更精确地说，是2006-01-02 15:04:05 -0700 MST）来定义输出格式。这意味着，如果你想输出年份，你需要使用参考时间中的年份2006；如果你想输出月份，你需要使用参考时间中的月份01。
下表展示了参考时间各部分与常见格式的对应关系：
| 参考时间部分 | 含义 | 对应格式字符串 |
|---|---|---|
| 2006 | 年份 | YYYY |
| 01 | 月份 | MM |
| 02 | 日期 | DD |
| 15 | 小时（24制） | HH |
| 04 | 分钟 | MM |
| 05 | 秒钟 | SS |
| Mon | 星期几 | Mon |
| Jan | 月份缩写 | Jan |
| MST | 时区缩写 | MST |
因此，要实现YYYY-MM-DD HH:MM:SS的格式，我们需要使用"2006-01-02 15:04:05"作为格式字符串。
立即学习“go语言免费学习笔记（深入）”；
从Unix时间戳转换与格式化
在实际应用中，我们经常会从数据库或其他源获取到int64类型的Unix时间戳（秒或纳秒）。Go语言提供了time.Unix()函数将Unix时间戳转换为time.Time对象。time.Unix()函数的签名是func Unix(sec int64, nsec int64) Time，它接受两个参数：第一个是秒数（sec），第二个是纳秒数（nsec）。
一个常见的错误是混淆这两个参数的顺序或使用方式。如果你的int64时间戳代表的是纳秒，那么它应该作为第二个参数nsec传入，而第一个参数sec应为0。
例如，如果p.Created是一个表示纳秒的int64，正确的转换和格式化方式如下：
// 假设 p.Created 是一个 int64 类型的纳秒时间戳 // 正确的格式字符串 const createdFormat = "2006-01-02 15:04:05" // 将纳秒时间戳转换为 time.Time 对象，并格式化 formattedTime := time.Unix(0, p.Created).Format(createdFormat) fmt.Println(formattedTime)
如果p.Created是一个表示秒的int64，则应这样使用：
// 假设 p.Created 是一个 int64 类型的秒时间戳 const createdFormat = "2006-01-02 15:04:05" formattedTime := time.Unix(p.Created, 0).Format(createdFormat) fmt.Println(formattedTime)
完整示例代码
以下是一个修正后的完整Go程序示例，演示了如何从数据库中获取一个int64纳秒时间戳，并将其正确格式化为YYYY-MM-DD HH:MM:SS字符串：
package main
import (
"database/sql"
"fmt"
_ "github.com/go-sql-driver/mysql" // MySQL驱动
"log"
"time"
)
// Post 结构体用于映射数据库表
type Post struct {
Id int64
Created int64 // 假设这是纳秒时间戳
Title string
Body string
}
func main() {
// 数据库连接字符串，请根据实际情况修改
// 例如: "user:password@tcp(127.0.0.1:3306)/testdb?parseTime=true"
// parseTime=true 对于直接将DATETIME/TIMESTAMP字段扫描到time.Time类型非常有用
dsn := "root:@tcp(127.0.0.1:3306)/testdb" // 假设没有密码，根据实际情况修改
con, err := sql.Open("mysql", dsn)
if err != nil {
log.Fatalf("无法连接到数据库: %v", err) // 使用Fatalf在连接失败时退出
}
log.Println("数据库连接已建立")
defer con.Close()
// 尝试创建表和插入数据（如果不存在），以便测试
_, err = con.Exec(`
CREATE TABLE IF NOT EXISTS posts (
id INT AUTO_INCREMENT PRIMARY KEY,
created BIGINT,
title VARCHAR(255),
body TEXT
);
`)
if err != nil {
log.Printf("创建表失败: %v", err)
}
// 插入一条测试数据，使用当前时间的纳秒时间戳
_, err = con.Exec(`
INSERT INTO posts (created, title, body) VALUES (?, ?, ?)
`, time.Now().UnixNano(), "测试标题", "这是一篇测试文章内容。")
if err != nil {
log.Printf("插入数据失败: %v", err)
}
// 查询一条记录
row := con.QueryRow("SELECT id, created, title, body FROM posts ORDER BY id DESC LIMIT 1")
p := new(Post)
err = row.Scan(&p.Id, &p.Created, &p.Title, &p.Body)
if err != nil {
log.Fatalf("获取Post失败: %v", err) // 获取失败时退出
}
// 定义正确的格式字符串
// Go语言时间格式化使用参考时间 "Mon Jan 2 15:04:05 MST 2006"
// 2006-01-02 15:04:05 对应 YYYY-MM-DD HH:MM:SS
const createdFormat = "2006-01-02 15:04:05"
// 将纳秒时间戳 p.Created 转换为 time.Time 对象，然后格式化
// time.Unix(sec, nsec) - 第一个参数是秒，第二个是纳秒
formattedCreatedTime := time.Unix(0, p.Created).Format(createdFormat)
fmt.Printf("查询到的Post: %+v\n", p)
fmt.Printf("格式化后的创建时间: %s\n", formattedCreatedTime)
// 也可以直接将数据库中的DATETIME/TIMESTAMP字段扫描到time.Time类型
// 前提是DSN中设置了 parseTime=true
type PostWithTime struct {
Id int64
Created time.Time // 直接扫描到 time.Time
Title string
Body string
}
rowWithTime := con.QueryRow("SELECT id, created, title, body FROM posts ORDER BY id DESC LIMIT 1")
pwt := new(PostWithTime)
// 注意：如果数据库中的created字段是BIGINT存储纳秒，此处需要先转换
// 如果数据库中的created字段是DATETIME/TIMESTAMP，且DSN有parseTime=true，则可以直接扫描
// 为了演示，我们假设数据库的created字段是BIGINT，所以这里无法直接扫描到time.Time
// 实际应用中，如果数据库字段是DATETIME/TIMESTAMP，更推荐直接扫描到time.Time
// 假设我们的created字段是DATETIME/TIMESTAMP类型，并DSN中已配置parseTime=true
// 为了适配当前示例的`BIGINT` created，我们保持扫描到`int64`再转换
// 如果要直接扫描到`time.Time`，数据库字段类型需为`DATETIME`或`TIMESTAMP`
// 这里不再重复扫描，仅作说明。
}代码中的关键修正点：
- 格式字符串修正： const createdFormat = "2006-01-02 15:04:05"。原代码中使用了"2010-01-01 20:01:00"，这会得到意料之外的输出，因为Go只识别2006-01-02 15:04:05作为参考。
- time.Unix()参数修正： time.Unix(0, p.Created)。原代码中p.Created是纳秒时间戳，应作为nsec参数传入，sec参数设为0。
注意事项
- Go语言时间格式的“魔法数字”： 记住2006-01-02 15:04:05这个参考时间是Go时间格式化的核心。你可以将其理解为：年(06)月(01)日(02)时(15)分(04)秒(05)。
- 时区处理： time.Unix()返回的时间是UTC时间。如果你需要将其格式化为本地时区的时间，可以先使用time.Unix(0, p.Created).In(time.Local)转换为本地时区，然后再进行格式化。
- 数据库字段类型： 如果数据库中的时间字段本身就是DATETIME或TIMESTAMP类型，并且你的数据库连接字符串中包含了parseTime=true（对于go-sql-driver/mysql），那么你可以直接将这些字段扫描到Go的time.Time类型变量中，而无需手动进行Unix时间戳转换。这通常是更推荐的做法。
- 错误处理： 在实际应用中，务必对数据库操作、时间转换和格式化可能产生的错误进行充分的检查和处理，以确保程序的健壮性。
总结
掌握Go语言中time.Format()方法的参考时间机制是正确格式化时间的关键。通过使用"2006-01-02 15:04:05"作为格式字符串，并正确理解time.Unix()函数的参数，开发者可以轻松地将Go时间对象或Unix时间戳格式化为符合YYYY-MM-DD HH:MM:SS标准的字符串，从而满足与MySQL等数据库交互的需求。在处理数据库时间字段时，优先考虑利用驱动的parseTime选项直接将数据库时间映射到time.Time类型，以简化代码并提高可靠性。
