本文详解如何使用 Go 的 time.Parse 正确解析 ISO/自定义格式的日期字符串，并将解析后的 time.Time 值安全传入 PostgreSQL，避免零值、时区错误及 SQL 类型不匹配问题。
本文详解如何使用 go 的 `time.parse` 正确解析 iso/自定义格式的日期字符串，并将解析后的 `time.time` 值安全传入 postgresql，避免零值、时区错误及 sql 类型不匹配问题。
在 Go 中解析日期字符串并写入 PostgreSQL 是常见但易出错的操作。核心问题常源于两点：布局字符串（layout）错误和时区/类型传递不当。例如，原代码中使用 "2016-06-10" 作为 layout（实际应为参考时间 "2006-01-02"），导致 time.Parse 返回零时间 0001-01-01。
✅ 正确解析日期字符串
Go 的 time.Parse 要求 layout 必须是固定的参考时间 "2006-01-02 15:04:05 MST" 的格式化变体（即“Mon Jan 2 15:04:05 MST 2006”的各部分顺序）。常见布局示例如下：
| 输入字符串示例 | 对应 layout 字符串 |
|---|---|
| "2016-06-10" | "2006-01-02" |
| "2016-06-10T14:30:00Z" | "2006-01-02T15:04:05Z" |
| "2016-06-10T14:30:00.123Z" | "2006-01-02T15:04:05.000Z" |
✅ 正确示例：
layout := "2006-01-02"
updatedAt, err := time.Parse(layout, "2016-06-10")
if err != nil {
log.Fatal("解析失败:", err)
}
fmt.Println(updatedAt) // 输出：2016-06-10 00:00:00 +0000 UTC⚠️ 注意：若输入含时区（如 Z 或 +0800），layout 中必须显式包含对应时区标识（Z 或 MST/-0700），否则解析会失败或忽略时区。
✅ 安全插入 PostgreSQL
PostgreSQL 原生支持 TIMESTAMP WITH TIME ZONE（timestamptz）和 TIMESTAMP WITHOUT TIME ZONE（timestamp）类型。强烈推荐使用 timestamptz，并确保 Go 中的 time.Time 包含有效时区信息。
- time.Parse 默认返回 UTC 时间（无本地时区）；
- 若需保留原始时区（如 "2016-06-10T14:30:00+0800"），使用 time.ParseInLocation 并指定 time.Local 或自定义 *time.Location；
- 使用 database/sql 执行插入时，直接传入 time.Time 值即可，驱动（如 lib/pq 或 pgx）会自动处理序列化：
_, err := db.Exec(
"INSERT INTO posts (title, updated_at) VALUES ($1, $2)",
"My Post",
updatedAt, // ✅ 直接传 *time.Time，无需转字符串
)
if err != nil {
log.Fatal("插入失败:", err)
}? 表结构建议（PostgreSQL）：
CREATE TABLE posts (
id SERIAL PRIMARY KEY,
title TEXT,
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);⚠️ 关键注意事项
- 永远检查 err：忽略 time.Parse 错误是零时间的最常见原因；
- 避免硬编码空 _ 忽略错误（如 _, _ := time.Parse(...)），这会让故障静默；
- 时区一致性：若业务逻辑依赖本地时间，统一使用 time.Local 解析，并在数据库中存储为 timestamptz；PostgreSQL 会将其标准化为 UTC 存储，查询时按会话时区自动转换；
- 驱动兼容性：pgx 比 lib/pq 更现代、性能更好，且对 time.Time 支持更健壮，推荐生产环境使用。
掌握正确的 layout 格式与 time.Time 的直传机制，即可高效、可靠地完成 Go → PostgreSQL 的时间数据流转。
