Go语言无法用time.Sub直接计算准确月份差，因月份天数不固定且跨年闰年逻辑复杂；需统一时区后基于Year/Month字段手动计算，并处理起始日大于结束日的借位情况。
Go 语言没有内置的“月份差”计算函数，time.Sub 返回的是精确到纳秒的总时长，不能直接反映“隔了几个月”——比如从 1 月 31 日到 2 月 28 日，Sub 算出来是 28 天，但业务上常认为是 1 个月差。
为什么不能用 time.Sub 直接算月份差
因为月份天数不固定（28/30/31），且跨年、跨闰年时逻辑复杂。直接除以 30 天或 365.25/12 都会出错：2023-01-31 到 2023-02-28 是合法日期区间，但按天数差（28）除以平均月长 ≈ 0.92 个月，而人眼和业务规则认定就是 1 个月。
- 用
Sub得到time.Duration，再换算成“月”纯属近似，无法满足财务、订阅、合同期限等场景 - Go 标准库
time包不提供MonthDiff或类似方法，必须自己实现基于年/月/日字段的逻辑 - 注意时区：两个
time.Time若在不同时区，直接比较年月可能因本地时间偏移导致错误（例如2023-01-01T00:00Z和2023-01-01T00:00+08在 UTC 下其实是不同日期）
手动计算年月差的核心逻辑（推荐方案）
本质是提取两个时间的 Year() 和 Month()，做整数运算，并处理“起始日 > 结束日”的借位情况。关键不是看天数，而是看“是否已过目标月的同日”。
- 先统一转成同一时区（常用
time.UTC或业务指定时区），避免本地时间干扰 - 计算基础月份数：
(end.Year()-start.Year())*12 + int(end.Month()) - int(start.Month()) - 再判断是否“没到目标日”：如果
end.Day() ，说明还没真正满一个月，结果减 1 - 注意边界：若
start.Day()是 31 日，而end.Month()没有 31 日（如 2 月），Go 的time.Date会自动归约（2023-01-31.AddDate(0,1,0) →2023-02-28），此时end.Day() == 28 ，应减 1
示例：
立即学习“go语言免费学习笔记（深入）”；
func MonthDiff(start, end time.Time) int {
start = start.In(time.UTC)
end = end.In(time.UTC)
months := (end.Year()-start.Year())*12 + int(end.Month()) - int(start.Month())
if end.Day() < start.Day() {
months--
}
return months
}使用 time.AddDate 反向验证更稳妥
对精度要求高的场景（如计费、法律条款），建议不用纯数学推导，改用“试加法”：从起始时间逐月增加，直到超过结束时间。虽然略慢，但语义清晰、无歧义。
-
start.AddDate(0, n, 0)表示加 n 个月（天数自动归约，安全） - 循环条件：当
start.AddDate(0, n, 0).After(end)时，n-1就是最大完整月数 - 注意不要用
Add（纳秒加法），必须用AddDate，否则遇到 1 月 30 日 + 1 个月会变成 3 月 2 日之类错误结果 - 该方法天然兼容所有闰年、大小月、月末归约逻辑，无需手动判断
Day()
简单实现：
func MonthDiffSafe(start, end time.Time) int {
if start.After(end) {
return 0
}
n := 0
for start.AddDate(0, n, 0).Before(end) || start.AddDate(0, n, 0).Equal(end) {
n++
}
return n - 1
}容易被忽略的时区与月末归约问题
最常踩的坑不是算法本身，而是输入时间的时区和构造方式。比如：
- 用
time.Parse("2006-01-02", "2023-01-31")解析，得到的时间默认是本地时区，若服务器在 UTC+8，而用户数据本意是 UTC，则后续所有Year()/Month()都偏移了 - 直接传入
time.Now()做计算，没调用In(...)统一时区，会导致同一天在不同时区下算出不同月差 - 测试时用
time.Date(2023, 1, 31, 0, 0, 0, 0, time.UTC)构造，但生产中可能来自 HTTP 参数或数据库，需确认其Location()是否一致
月份差不是数学题，是业务规则映射。哪怕代码跑通，只要时区或日期归约没对齐，结果就不可信。
