如何使用Golang处理时间解析错误_Golangtime.Parse异常捕获与处理_技术教程

time.Parse 解析失败时返回 *time.ParseError 类型的非 nil 错误，包含原始字符串、预期格式和出错位置等诊断信息，需显式检查 err != nil 而不可忽略或用 == 比较。

time.Parse 解析失败时返回什么错误

time.Parse 解析失败时不会 panic，而是返回一个非 nil 的 error 值，类型通常是 *time.ParseError。这个错误包含原始字符串、预期格式、出错位置等信息，可用于诊断，但不能直接用 == 与预定义错误比较（它不是变量，是结构体指针）。

常见错误现象：
- 输入字符串为 "2025-13-01"（月份越界）→ 报 month out of range
- 格式写成 "2006/01/02" 但输入是 "2025-01-01" → 报 parsing time ... as ...: cannot parse ...

永远检查 err != nil，不要忽略返回值
不要用 errors.Is(err, xxx) 判断具体原因（*time.ParseError 没有导出的哨兵错误）
调试时可打印 err.Error()，生产环境建议记录原始输入 + 错误消息

如何安全地解析多种时间格式

Go 标准库不提供“尝试多个格式”的内置函数，必须手动轮询。关键点是：避免重复解析成功字符串、控制尝试次数、明确优先级。

func parseTimeMulti(s string) (time.Time, error) {
    formats := []string{
        time.RFC3339,
        "2006-01-02T15:04:05",
        "2006-01-02 15:04:05",
        "2006-01-02",
    }
    for _, format := range formats {
        if t, err := time.Parse(format, s); err == nil {
            return t, nil
        }
    }
    return time.Time{}, fmt.Errorf("unable to parse time: %q", s)
}

把最可能匹配的格式放前面，减少平均尝试次数
避免在循环里解析明显不匹配的格式（例如输入含 T 就跳过空格分隔格式）
注意 time.RFC3339 已包含时区，若输入无时区（如 "2025-01-01T12:00:00"），会失败；可补 "Z" 或改用 time.RFC3339Nano 等变体