给 1 月 31 日加一个月
time.AddDate(0,1,0) 作用在 1 月 31 日上会归一化成 3 月 3 日——因为「2 月 31 日」不存在,Go 把多出来的天往后顺延。MySQL 的 DATE_ADD 则直接截断到 2 月 28 日。两种行为都有文档、单独看都算对,但用一层算边界、另一层算数据的报表,会在不报任何错的情况下差最多五天。
一个月度报表错了三天却不报错,比直接崩掉更糟。整件事两次运行就能讲完。
Go:四个日期,一个下午
for _, d := range []time.Time{
time.Date(2026, 1, 31, 0, 0, 0, 0, time.UTC),
time.Date(2026, 3, 31, 0, 0, 0, 0, time.UTC),
time.Date(2026, 8, 31, 0, 0, 0, 0, time.UTC),
time.Date(2024, 1, 31, 0, 0, 0, 0, time.UTC),
} {
fmt.Printf("%s +1 -> %s\n", d.Format("2006-01-02"), d.AddDate(0, 1, 0).Format("2006-01-02"))
}
2026-01-31 +1 month -> 2026-03-03 (+2 months -> 2026-03-31)
2026-03-31 +1 month -> 2026-05-01 (+2 months -> 2026-05-31)
2026-08-31 +1 month -> 2026-10-01 (+2 months -> 2026-10-31)
2024-01-31 +1 month -> 2024-03-02 (+2 months -> 2024-03-31)
每一条都是 Go 在照文档办事:月份加一、日期不动、不存在的日期往后归一。1 月 31 日加一个月就是「2 月 31 日」,也就是 3 月 3 日;闰年是 3 月 2 日。
注意右边那列 +2:对这些日期它反而是对的。这个 bug 之所以能藏住,正是因为同一个函数在另一个偏移量上给出正确答案。
MySQL:同一个问题
SELECT DATE_ADD('2026-01-31', INTERVAL 1 MONTH) AS jan31_plus1,
DATE_ADD('2026-03-31', INTERVAL 1 MONTH) AS mar31_plus1,
LAST_DAY('2026-02-01') AS last_day_feb;
+-------------+-------------+--------------+
| jan31_plus1 | mar31_plus1 | last_day_feb |
+-------------+-------------+--------------+
| 2026-02-28 | 2026-04-30 | 2026-02-28 |
+-------------+-------------+--------------+
MySQL 选择截断:它不肯发明一个 2 月 31 日,直接落到当月最后一天。一个标准库加两个数据库方言,都在「加一个月」,1 月 31 日却映射出三个不同的日期——差别只取决于算术发生在哪一层。
它真实造成的故障
Go 算边界、SQL 过滤的报表:
now := time.Date(2026, 3, 31, 10, 0, 0, 0, time.UTC) // 「跑 3 月的报表」
from := now.AddDate(0, -1, 0) // 预期 2026-02-28,实得 2026-03-03
rows := db.Query("... WHERE created_at >= ? AND created_at < ?", from, now)
now = 2026-03-31
AddDate(0,-1,0) = 2026-03-03 <- 报表实际用的窗口起点
代码算出的窗口是 [3 月 3 日, 3 月 31 日)——它默默丢掉了 3 月 1 日和 2 日,而且完全没覆盖 2 月。没有报错、没有空页面:一个少两天、看起来毫无异常的数值。
两层都安全的写法
y, m, _ := now.Date()
monthStart := time.Date(y, m, 1, 0, 0, 0, 0, now.Location()) // 2026-03-01
prevStart := monthStart.AddDate(0, -1, 0) // 2026-02-01
// 「上个月」窗口:[prevStart, monthStart)
monthStart = 2026-03-01
prevStart = 2026-02-01 <- 日期恒为 1,永不溢出
把日期钉到 1 号,等于从一开始就不让「2 月 31 日」这种输入出现——没有不存在的日期,就没有归一化。日期字段永远是 1,AddDate 重新变得无聊。
如果非要放在 SQL 里算,LAST_DAY() 就是那个 clamp,而且它和 MySQL 对 DATE_ADD 用的截断是同一个规则。
怎么知道它真的修好了
- 测 31 号,别测 15 号。 只用月中日期的边界测试,上面四种实现全都能通过。把 2026-01-31、2026-03-31、2026-08-31、2024-01-31 写进用例。
- 断言天数,而不是断言日期。 「1 月窗口 31 天、2 月 28 天」能同时抓住截断与溢出,且两个方向都管用。
- 同一组用例在两层各跑一遍再 diff。 本文里这个差是 5 天(
2026-02-28对2026-03-03);只要结果不是零,就是你的 bug——不管两层各自声称自己多正确。
怎么回滚
- 已经生成过的报表:用截断规则重算,先把「逐日总数」比一遍再替换。边界挪三天会把收入从一个月份搬到另一个月份;直接覆盖旧数,等于销毁「搬了多少」的证据。
- 落库的边界:如果持久化了算出来的
from/to,把原始时间戳一并存下来,这样以后修的时候是重算,不是猜。 - 共享 helper 里的
AddDate:只改一处,但上线前必须 grep 所有调用点——同一个调用对+2 months是对的、对+1是错的,随手抽检会骗你。
相关档案
常见问题
为什么 AddDate(0,1,0) 对 1 月 31 日返回 3 月 3 日?
因为它把月份加一、日期仍留 31。「2 月 31 日」不存在,Go 就往后归一到 3 月 3 日;闰年是 3 月 2 日。没有报错,也没有警告。
MySQL 也这样吗?
不。DATE_ADD 不认 31 号,直接截到当月最后一天:1 月 31 日加一个月是 2 月 28 日。所以同一条业务规则,在哪一层算,结果就不一样。
取「下个月的今天」安全写法是什么?
先把日期钉到当月 1 号,再加月份,最后按需 clamp 到 LAST_DAY。而且只在一层算——要么全在 Go,要么全在 SQL,绝不要拿 Go 算的边界去和 SQL 算的边界比。
哪个是对的?
没有绝对的对;截断更符合账期与报表习惯。问题不在选哪个,而在两层各选了一个、并且从没测过每个月的最后一天。
来源
本文最后一次核验:2026-11-18 · Go 输出来自 go1.27.0(Windows 11),SQL 输出来自 MySQL 8.4.13(Ubuntu 26.04 / WSL)。本页两段输出均原样粘贴,含闰年那一例。