本文详解 Go 语言中安全、精准地为 time.Time 类型添加天数（如将周数转换为天数后叠加）的正确方法，重点介绍 AddDate 的使用场景、优势及常见误区。
本文详解 go 语言中安全、精准地为 `time.time` 类型添加天数（如将周数转换为天数后叠加）的正确方法，重点介绍 `adddate` 的使用场景、优势及常见误区。
在 Go 中，向一个 time.Time 值添加天数看似简单，但若误用 Add() 方法配合 time.Hour 进行手动换算，极易引发类型错误或逻辑偏差——正如问题中所示：time.Hour * 24 * 7 * weeksToAdd 会因 weeksToAdd 是 float64 或 int 而与 time.Duration 类型不兼容（Go 不支持 Duration 与非 int64 数值直接相乘）。更关键的是，这种基于小时的粗略计算忽略闰秒、夏令时切换和日历边界问题，可能导致日期偏移（例如在 DST 起始/结束当日加减 24 小时，可能实际跨越 23 或 25 小时）。
✅ 正确且推荐的方式是使用 time.Time.AddDate(years, months, days int) 方法：
// 示例：向当前时间添加 3 周（即 21 天） t := time.Date(2024, 5, 15, 10, 30, 0, 0, time.UTC) weeksToAdd := 3 newTime := t.AddDate(0, 0, 7*weeksToAdd) // → 2024-06-05 10:30:00 +0000 UTC
AddDate 是语义化的日历运算：它按真实日历天数增减（自动处理月份天数差异、闰年等），完全规避了时区与夏令时带来的歧义。参数中 years 和 months 可为负数，days 支持任意整数（正/负/零），且底层已做溢出校验（如 2024-01-31.AddDate(0, 0, 30) 会智能返回 2024-03-01，而非无效日期）。
⚠️ 注意事项：
- AddDate 不接受浮点数，因此 weeksToAdd 必须为 int（可安全转换：int(weeksToAdd)，若原始值含小数请先明确舍入策略）；
- 若需添加“精确的 24 小时 × N”（如严格按 Unix 时间戳偏移，无视日历），才应使用 Add() 配合 time.Hour * 24 * n，但此时必须确保 n 是 int64：
newTime := t.Add(time.Hour * 24 * time.Duration(days)) // ✅ 正确类型转换
- AddDate(0, 0, 0) 等价于原时间，无副作用；传入负数可实现“减去天数”。
? 总结：对绝大多数业务场景（如“订单发货日期 = 下单日 + 7 天”、“订阅到期日 = 开通日 + 30 天”），请始终优先选用 AddDate(0, 0, days) —— 它语义清晰、日历安全、类型友好，是 Go 标准库为日期算术提供的权威解决方案。
