详解Golang时间处理的踩坑及解决

核心时间与时区概念

Golang 的 time 包提供了基础的时间处理工具：

• Time：time.Time 结构体，精确到纳秒，保存特定时刻的时间点。
• Location：time.Location，表示具体的时区信息，如 time.Local（本地）或 time.UTC（协调世界时）。
• Duration：两个时间点之间的差值，通常以纳秒为底层单位。

程序间传递时间对象时，务必使用值类型的 time.Time，而非指针 *time.Time，以确保线程安全。

极易忽视的时区陷阱

在处理外部输入的时间字符串时，默认的解析逻辑是导致“时间不对”的头号原因。

场景：从字符串转换为 Time

如果你使用 time.Parse 解析一个标准格式字符串，返回的时间对象会被强制设为 UTC 时区：

timeStr := "2022-01-13 22:32:17"
utcTimeObj, err := time.Parse("2006-01-02 15:04:05", timeStr)
// 结果输出: 2022-01-13 22:32:17 +0000 UTC

在中国（东八区），这会导致实际时间与预期时间相差 8 小时。

localTimeObj, err := time.ParseInLocation("2006-01-02 15:04:05", timeStr, time.Local)
// 结果输出: 2022-01-13 22:32:17 +0800 CST

JSON数据交互中的时间处理

前后端交互时，前端可能传来时间字符串而要求后端转为时间戳，或者直接接收 JSON 字符串形式的日期字段。直接使用 Go 默认的 JSON 反序列化会报错或得到错误结果。

方案一：重新定义 Time 类型

这是最通用且优雅的做法。通过自定义类型实现 json.Unmarshaler 和 json.Marshaler 接口：

type Time time.Time
const timeFormart = "2006-01-02 15:04:05"

func (t *Time) UnmarshalJSON(data []byte) (err error) {
    now, err := time.ParseInLocation(`"`+timeFormart+`"`, string(data), time.Local)
    *t = Time(now)
    return
}

func (t Time) MarshalJSON() ([]byte, error) {
    b := make([]byte, 0, len(timeFormart)+2)
    b = append(b, '"')
    b = time.Time(t).AppendFormat(b, timeFormart)
    b = append(b, '"')
    return b, nil
}

使用该自定义类型后，标准 encoding/json.Unmarshal 即可自动正确处理。

方案二：在结构体方法中重写解析

如果不想全局修改，可以针对具体结构体手动处理：

type Person struct {
    Id       int64  `json:"id"`
    Name     string `json:"name"`
    Birthday Time   `json:"birthday"`
}

func (p *Person) UnmarshalJSON(b []byte) error {
    type tmp Person // 创建别名避免递归
    var s = &struct {
        tmp
        Birthday string `json:"birthday"` // 先当作字符串接收
    }{}

    if err := json.Unmarshal(b, &s); err != nil { return err }
    
    localTimeObj, err := time.ParseInLocation("2006-01-02 15:04:05", s.Birthday, time.Local)
    if err != nil { return err }
    
    s.tmp.Birthday = localTimeObj
    *p = Person(s.tmp)
    return nil
}

常用时间操作速查

格式化与时区切换

curLocalTime := time.Now()
curUTCTime := time.Now().UTC() 
fmt.Println(curLocalTime.Format("2006-01-02 15:04:05")) // 转字符串

时间加减计算

利用 Add 方法及预定义的常量进行灵活运算：

t := time.Now()
t.Add(time.Hour * 2)      // 加两小时
t.AddDate(1, 0, 0)        // 加一年

时间取整（截断/舍入）

将时间对齐到分钟或小时的边界：

t.Truncate(1 * time.Hour)  // 向下取整到整点
t.Round(1 * time.Minute)   // 四舍五入到最近的整分