本文详解如何使用 Go 标准库 time 包将整型 Unix 时间戳（秒级）准确转换为指定格式的日期字符串，包括本地时区与 UTC 时区处理，并输出 ISO 8601 标准格式（如 2016-07-15）。
本文详解如何使用 go 标准库 `time` 包将整型 unix 时间戳（秒级）准确转换为指定格式的日期字符串，包括本地时区与 utc 时区处理，并输出 iso 8601 标准格式（如 `2016-07-15`）。
在 Go 中，Unix 时间戳（即自 1970-01-01 00:00:00 UTC 起经过的秒数）是一个整数类型值。要将其解析为人类可读的日期，不能使用 time.ParseDuration——该函数用于解析持续时间（如 "2h30m"），而非时间点。正确方式是调用 time.Unix(sec, nsec)，其中 sec 为秒数，nsec 为纳秒偏移（通常设为 0）。
✅ 基本转换步骤
- 将整型时间戳转为
int64（因time.Unix参数要求int64）； - 调用
time.Unix()构造time.Time对象； - 显式设置时区（推荐
.UTC()或.In(loc)，避免依赖本地时区隐式行为）； - 使用
t.Format(layout)输出指定格式字符串。
Go 的时间格式化采用“参考时间” Mon Jan 2 15:04:05 MST 2006（即 2006-01-02 15:04:05），因此：
-
YYYY-MM-DD→"2006-01-02" - ISO 8601 全格式（含时分秒时区）→
"2006-01-02T15:04:05Z07:00"
? 示例代码（UTC 时区）
package main
import (
"fmt"
"time"
)
func main() {
x := 1468540800 // 对应 UTC 时间：2016-07-15 00:00:00
t := time.Unix(int64(x), 0).UTC()
fmt.Println(t.Format("2006-01-02")) // 输出：2016-07-15
fmt.Println(t.Format("2006-01-02T15:04:05Z")) // 输出：2016-07-15T00:00:00Z
}⚠️ 注意事项
-
时区至关重要：
time.Unix()默认返回本地时区时间（受$TZ环境变量或系统设置影响）。若需确定性结果（如服务端统一处理），务必显式调用.UTC()或.In(time.UTC)； -
纳秒参数：若时间戳含毫秒/微秒精度，需将高位部分转为秒，低位转为纳秒（例如
1468540800123毫秒 →sec=1468540800, nsec=123000000）； -
边界安全：确保输入
x在int64范围内（Gotime.Time支持约 ±290 年，即1677–2262年），超出将导致未定义行为； -
格式验证：错误的 layout 字符串（如
"yyyy-MM-dd"）不会报错，但会输出字面量，务必使用 Go 官方布局常量或参考时间格式。
? 扩展：使用自定义时区
如需转换为北京时间（CST, UTC+8）：
loc, _ := time.LoadLocation("Asia/Shanghai")
t := time.Unix(int64(x), 0).In(loc)
fmt.Println(t.Format("2006-01-02")) // 2016-07-15（同 UTC，因该时间戳整点）掌握 time.Unix() 与 Format() 的组合，即可稳健、清晰地完成 Unix 时间戳到结构化日期字符串的转换，适用于日志分析、API 响应、数据库写入等典型场景。
