Go time.ParseDuration 解析小时分钟混合值失败怎么办

Go 里用 time.ParseDuration 解析“2 小时 45 分钟”失败，通常不是小时和分钟不能混合，而是字符串没有使用 Go 规定的单位写法。标准格式是 2h45m：数字后紧跟单位，小时用 h，分钟用 m。2h 45m、2h45min、2小时45分钟 都不属于同一种语法。

先确认 ParseDuration 能接受什么单位

time.ParseDuration 接收一串带单位的十进制数字，数字可以带小数，整串可以带正负号。小时和分钟混合时不需要分隔符，写成 2h45m 即可；如果还包含秒，就是 2h45m10s。

微秒是一个容易忽略的例外：标准库同时接受 us 和微秒符号 µs。输入若来自配置文件或 JSON，建议统一保存 ASCII 写法，减少编码、复制和日志展示差异。

旧字符串为什么会在解析时失败

最常见的旧写法来自业务字段的自然语言格式。例如前端传回 120min，或者把两个输入框拼成 2h 45m。这些字符串对人很直观，却不符合 ParseDuration 的单位词法。这里先不要用正则把所有格式都“猜”成时长，否则很容易把拼写错误静默转换成错误配置。

如果数据源本来就是 Go 配置，直接约定 30s、5m、2h45m 最省事。如果数据源面向普通用户，可以在输入层把“小时”和“分钟”分别转成整数，再由程序组合成标准字符串；不要让用户负责记住 h 和 m。

package main

import (
    "fmt"
    "time"
)

func main() {
    raw := "2h45m" // 外部配置应约定为数字紧跟单位的格式。
    duration, err := time.ParseDuration(raw)
    if err != nil { // 失败时保留原始输入，便于定位配置来源。
        fmt.Printf("无法解析时长 %q: %v\n", raw, err)
        return
    }
    fmt.Printf("duration=%s, minutes=%.0f\n", duration, duration.Minutes())
}

不要写成 duration, _ := time.ParseDuration(raw)。解析失败时返回的 Duration 不能替代业务默认值；如果确实需要默认值，应在确认错误类型和输入来源后显式决定，并记录这次回退。

把外部输入转换成清晰的解析边界

配置值可能带有首尾空格，使用 strings.TrimSpace 可以处理这类传输噪声，但它不会把内部的 2h 45m 变成合法值。下面的函数只负责“清理首尾空白、调用标准解析器、返回错误”，不擅自接受中文单位或 min 等别名。

func parseTimeout(raw string) (time.Duration, error) {
    value := strings.TrimSpace(raw) // 只清理首尾空白，不掩盖内部格式错误。
    if value == "" {
        return 0, fmt.Errorf("时长不能为空") // 空值和格式错误分开提示。
    }
    duration, err := time.ParseDuration(value)
    if err != nil {
        return 0, fmt.Errorf("时长 %q 应使用 2h45m、30s 这类格式: %w", value, err)
    }
    return duration, nil
}

这段代码需要导入 fmt、strings 和 time。如果分钟来自两个独立字段，可以先做范围检查，再计算 time.Duration(hours)*time.Hour + time.Duration(minutes)*time.Minute；这样也能明确决定是否允许 90 分钟，避免把“格式解析”和“业务校验”混成一件事。

上线前用一张清单覆盖回归边界

把失败案例写进表驱动测试或配置校验清单，重点检查“应该拒绝”的值。成功并不只意味着得到一个数字，还要确认单位含义没有被转换错。

如果项目升级了 Go 版本，ParseDuration 的核心格式约束仍应以当前 time 包文档为准；迁移时真正需要核对的是调用方是否偷偷改变了单位、空格或默认值策略。

相关问题

为什么 1h60m 也能解析成功？

它表达的是 2 小时，解析器关注的是单位串的合法性，不负责判断分钟字段是否符合你的表单规则。若业务要求分钟小于 60，需要单独校验字段。

能不能用 time.Parse 解析 2h45m？

不能。time.Parse 解析日期时间布局，时长字符串应使用 time.ParseDuration。

日、周这样的时长怎么写？

ParseDuration 没有 d 或 w 单位。日历天涉及时区和夏令时语义，应按业务选择日期运算，而不是简单乘以 24 小时。

因此，小时分钟混合值先统一成 2h45m，再让 ParseDuration 做标准解析；外部输入的别名、中文和字段范围，则留在输入层和业务校验层处理。