本文介绍如何在 go 语言中将 `time.time` 格式化为 postgresql 默认接受的微秒级 iso 8601 时间字符串（如 `2015-01-25t22:22:46.923331z`），替代标准 `rfc3339` 的秒级精度格式。
PostgreSQL 在处理 TIMESTAMP WITH TIME ZONE（即 timestamptz）类型时，官方文档明确推荐使用带微秒精度、UTC 时区（以 Z 结尾）的 ISO 8601 格式，例如：
2015-01-25T22:22:46.923331Z
而 Go 标准库中的 time.RFC3339（即 "2006-01-02T15:04:05Z"）仅支持秒级精度，且不包含小数秒部分，因此无法直接满足 PostgreSQL 的默认解析要求——尤其在批量插入、JSONB 时间字段或 COPY 导入等场景中，缺失微秒可能导致精度截断或解析失败。
✅ 正确做法是使用自定义布局字符串：
t := time.Now().UTC() // 关键：必须转为 UTC，确保末尾为 'Z'
formatted := t.Format("2006-01-02T15:04:05.000000Z")
fmt.Println(formatted) // 输出示例：2024-06-15T08:32:17.123456Z⚠️ 注意事项：
- 必须调用 .UTC()：PostgreSQL 的 Z 后缀严格表示 UTC 零时区；若使用本地时区或带偏移量（如 +08:00）的时间调用该格式，结果将不符合 PostgreSQL 默认期望，可能触发隐式转换或警告。
- 微秒精度由 .000000 控制：Go 的时间格式中，六个 0 表示纳秒部分截取至微秒（即除以 1000 取整）。Go 内部纳秒值会自动补零或截断，无需手动处理。
- 避免使用 time.RFC3339Nano：它输出形如 2006-01-02T15:04:05.999999999Z（纳秒级），PostgreSQL 虽可解析，但非其“默认”格式；实际部署中建议统一为微秒（6 位小数），与 pg_dump、psql \d 显示及多数 ORM（如 gorm、sqlc）的默认序列化行为一致。
? 小技巧：可封装为可复用函数提升可维护性：
func PostgresTime(t time.Time) string {
return t.UTC().Format("2006-01-02T15:04:05.000000Z")
}
// 使用示例
fmt.Println(PostgresTime(time.Now())) // 2024-06-15T08:32:17.123456Z总结：要精准匹配 PostgreSQL 默认时间格式，核心是两点——使用 2006-01-02T15:04:05.000000Z 布局字符串 + 确保输入时间为 UTC。这一组合既满足语法兼容性，也符合生产环境对精度与时区语义的一致性要求。
