
在 go 中,通过自定义布局字符串 `"2006-01-02t15:04:05.000000z"` 将 `time.time` 格式化为 postgresql 默认的 iso 8601 时间格式(含六位微秒、utc 时区标记 `z`),替代 `time.rfc3339` 的秒级精度与本地偏移表示。
PostgreSQL 默认接受并输出的时间字符串格式为 YYYY-MM-DDTHH:MM:SS.MICROSECONDSZ(例如 2015-01-25T22:22:46.923331Z),该格式严格使用 UTC 时间(即 Z 表示零时区偏移),且包含六位微秒精度(.923331 而非 .923 或 .923331000)。而 time.RFC3339(如 time.Now().Format(time.RFC3339))生成的是带本地时区偏移(如 +08:00)且仅保留纳秒级三位小数(即毫秒)的格式(如 2015-01-25T22:22:46+08:00),不满足 PostgreSQL 的默认输入要求。
要精确匹配 PostgreSQL 的标准格式,需同时满足两个条件:
✅ 使用 UTC 时间(调用 .UTC())
✅ 采用六位微秒精度的布局字符串
正确做法如下:
t := time.Now().UTC()
s := t.Format("2006-01-02T15:04:05.000000Z")
fmt.Println(s) // 输出示例:2024-05-20T08:32:17.123456Z⚠️ 注意事项:
- 布局字符串中的 000000 表示六位微秒(即纳秒部分截断/补零至微秒级),Go 的 time.Format 会自动将纳秒转换为对应精度的小数位(无需手动除法或截取);
- 必须调用 .UTC() —— 若直接对本地时间使用 "...Z" 布局,结果仍会显示本地时间值但强制标记为 Z,造成逻辑错误(时区不一致);
- 此格式可被 PostgreSQL 的 TIMESTAMP WITH TIME ZONE 字段直接解析,无需额外类型转换;
- 若需更高精度(如纳秒),PostgreSQL 实际支持纳秒存储,但其默认文本输出仍为微秒级(.923331),因此六位小数已完全兼容。
总结:使用 t.UTC().Format("2006-01-02T15:04:05.000000Z") 是最简洁、可靠且符合 PostgreSQL 实践的格式化方式。










