首页 > 后端开发 > Golang > 正文

Go语言时间格式化:实现MySQL风格的日期时间字符串输出

DDD
发布: 2025-11-22 18:17:02
原创
874人浏览过

Go语言时间格式化:实现MySQL风格的日期时间字符串输出

本教程详细讲解如何在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。

ClipDrop
ClipDrop

Stability.AI出品的图片处理系列工具(背景移除、图片放大、打光)

ClipDrop 112
查看详情 ClipDrop

例如,如果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`
    // 这里不再重复扫描,仅作说明。
}
登录后复制

代码中的关键修正点:

  1. 格式字符串修正: const createdFormat = "2006-01-02 15:04:05"。原代码中使用了"2010-01-01 20:01:00",这会得到意料之外的输出,因为Go只识别2006-01-02 15:04:05作为参考。
  2. 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类型,以简化代码并提高可靠性。

以上就是Go语言时间格式化:实现MySQL风格的日期时间字符串输出的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号