RFC 3339 在 Go 中：5 个日期解析错误及如何修复

在 Go 中解析 RFC 3339 / ISO-8601：为什么即使是经验丰富的开发者也会犯错

你是否曾在 Go 中写过类似 time.Parse("2006-01-02T15:04:05Z", input) 的代码，然后遇到错误，感觉这门语言在故意捉弄你？很熟悉吧。日期和时间解析是这样一个主题：看似简单，但实际上却隐藏着许多陷阱。

在 Stack Overflow 上，问题 "在 Go 中解析 RFC-3339 / ISO-8601 日期时间字符串" 已经获得了数千次浏览。人们混淆了格式，忘记了纳秒，受时区困扰，并对“神奇”的数字 2006-01-02T15:04:05Z 感到恼火。在本文中，我们将分析 5 个最常见的错误，并展示如何一劳永逸地避免它们。开始吧！

一点理论：什么是 RFC 3339 和 ISO 8601？

在深入代码之前，让我们快速了解一下这些术语。ISO 8601 是日期和时间的国际标准。RFC 3339 是它的“精简”版本，在 Web 中很流行（例如，在 JSON、API、日志中）。

典型的 RFC 3339 字符串如下所示：

2025-01-15T10:30:00Z\n2025-01-15T10:30:00+03:00\n2025-01-15T10:30:00.123456789Z

在 Go 中，解析使用函数 time.Parse(layout, value)。而有趣的部分就从这里开始。

错误 #1：错误的 layout（模板）——头痛的主要原因

Go 使用一种独特的方法：格式不是用 YYYY-MM-DD 这样的代码来指定，而是用一个具体的日期：Mon Jan 2 15:04:05 MST 2006。记住它很容易：01/02 03:04:05PM '06 -0700（月、日、时、分、秒、年、时区）。

新手经常尝试写类似这样的代码：

// ❌ 错误！\nt, err := time.Parse("YYYY-MM-DDTHH:MM:SSZ", "2025-01-15T10:30:00Z")

Go 根本无法理解这种格式。RFC 3339 的正确 layout 是 time.RFC3339：

// ✅ 正确\nt, err := time.Parse(time.RFC3339, "2025-01-15T10:30:00Z")\nif err != nil {\n    log.Fatal(err)\n}\nfmt.Println(t) // 2025-01-15 10:30:00 +0000 UTC

常量 time.RFC3339 等于字符串 "2006-01-02T15:04:05Z07:00"。请注意 Z07:00——这是时区的表示。

错误 #2：忽略纳秒（time.RFC3339 vs time.RFC3339Nano）

标准的 time.RFC3339 不支持纳秒。如果你的字符串包含秒的小数部分：

2025-01-15T10:30:00.123456789Z

……那么使用 time.RFC3339 解析会返回错误：

// ❌ 错误：将时间 "2025-01-15T10:30:00.123456789Z" 解析为 "2006-01-02T15:04:05Z07:00"：无法将 ".123456789Z" 解析为 "Z07:00"\nt, err := time.Parse(time.RFC3339, "2025-01-15T10:30:00.123456789Z")

解决方案是使用 time.RFC3339Nano：

// ✅ 正确\nt, err := time.Parse(time.RFC3339Nano, "2025-01-15T10:30:00.123456789Z")\nif err != nil {\n    log.Fatal(err)\n}\nfmt.Println(t) // 2025-01-15 10:30:00.123456789 +0000 UTC

建议： 如果你不确定是否会有纳秒，请使用 time.RFC3339Nano——它是向后兼容的，两种情况下都能正常工作。

错误 #3：时区——Z 或 +00:00 不一样吗？

字符串 2025-01-15T10:30:00Z 和 2025-01-15T10:30:00+00:00 含义相同（UTC），但如果 layout 指定不正确，Go 可能会以不同方式处理它们。

// ✅ 两种变体都能与 time.RFC3339 一起工作\nt1, _ := time.Parse(time.RFC3339, "2025-01-15T10:30:00Z")\nt2, _ := time.Parse(time.RFC3339, "2025-01-15T10:30:00+00:00")\nfmt.Println(t1.Equal(t2)) // true

但是，如果你编写自己的 layout，请务必小心：

\