本文介绍在 Go 中安全、准确地为 time.Time 类型添加天数（包括将周数转换为天数）的推荐方法，重点讲解 AddDate() 的使用优势、正确用法及常见误区。
本文介绍在 Go 中安全、准确地为 time.Time 类型添加天数（包括将周数转换为天数）的推荐方法，重点讲解 AddDate() 的使用优势、正确用法及常见误区。
在 Go 中，为日期添加天数最直接且语义清晰的方式是使用 time.Time.AddDate() 方法，而非通过 time.Duration 手动计算小时或纳秒。这是因为 AddDate() 专为日历运算设计：它能自动处理月份天数差异（如 2 月 28/29 日）、闰年、时区偏移等边界情况，而基于 Add() 的纯时间偏移（如 t.Add(24 * time.Hour * n)）仅做恒定纳秒累加，可能因夏令时切换或时区规则导致逻辑错误（例如跨 DST 变更时“多加”或“少加”一小时）。
✅ 正确做法：使用 AddDate(years, months, days)
该方法接收三个 int 类型参数，分别表示要增加的年、月、日数量。若只需添加天数，传入 (0, 0, days) 即可：
package main
import (
"fmt"
"time"
)
func main() {
myDate := time.Date(2024, time.March, 15, 10, 30, 0, 0, time.UTC)
weeksToAdd := 3 // int 类型，无需 float64
// ✅ 推荐：AddDate 处理日历逻辑，结果精确
result := myDate.AddDate(0, 0, 7*weeksToAdd) // 添加 21 天
fmt.Println("原始日期:", myDate.Format("2006-01-02"))
fmt.Println("+3 周后:", result.Format("2006-01-02")) // 输出: 2024-04-05
}⚠️ 注意事项：
- weeksToAdd 应为整数类型（如 int），避免浮点运算引入精度问题或类型不匹配错误；
- AddDate() 是日历感知的：例如 time.Date(2024, 1, 31, 0, 0, 0, 0, time.UTC).AddDate(0, 1, 0) 返回 2024-02-29（非 2024-02-31），而 Add(30*24*time.Hour) 则会跳到 2024-03-02，二者语义不同；
- 若需添加非整数天数（如 1.5 天），才考虑 Add() 配合 time.Duration，但须明确其为“绝对时间偏移”，并自行处理时区与 DST 风险；
- AddDate() 不修改原 Time 值，返回新 Time 实例，符合 Go 时间类型的不可变设计原则。
总结：对于添加天数、周数、月数等日历单位，请始终优先选用 AddDate()；仅当需要精确到纳秒级的物理时间偏移（如超时控制、定时器间隔）时，才使用 Add()。这不仅避免类型转换错误（如 float64 与 Duration 不可乘），更能保障业务逻辑的时间语义正确性。
