Go 语言生成每周五日期序列方法

本文深入讲解了在 Go 语言中精准、可靠地生成指定星期几（如每周五）的日期序列的完整实践方案，直击开发者常踩的时间偏移、重复计算、时间部分冗余等痛点，通过标准化起始对齐、基于当前日期迭代、严格截断时间、包容性边界判断四大核心策略，提供简洁健壮的原生实现；不仅附有可直接运行的完整代码与典型用例，还延伸覆盖时区处理、性能提示、高阶扩展（如“每月第三个周五”）及数据库写入最佳实践，助你用最少的依赖写出最清晰、最可维护的周期性日期逻辑。

本文介绍如何在 Go 中精准生成两个日期之间所有指定星期几（如每周日、每周五）的日期，避免时间偏移与重复问题，并输出纯日期格式（无时间部分）。

本文介绍如何在 Go 中精准生成两个日期之间所有指定星期几（如每周日、每周五）的日期，避免时间偏移与重复问题，并输出纯日期格式（无时间部分）。

在 Go 开发中，常需按周期性规则（如“每周五”“每月第一个周一”）生成日期序列，尤其在任务调度、报表生成或数据库批量插入场景中。但直接使用 AddDate(0, 0, 7) 迭代易导致逻辑错误：原始代码中 z := onDate.AddDate(0, 0, 7) 每次都基于初始 onDate 计算，而非上一次结果，造成日期恒定；同时未做星期对齐，也未剥离时间部分，导致存储或展示时出现 2015-08-23 00:00:00 +0000 UTC 等冗余信息。

✅ 正确做法是：

1. 标准化起始日期：将开始日期调整为首个目标星期几（例如，若要找周日且起始日是周一，则先回退 1 天）；
2. 逐周递进：使用 AddDate(0, 0, 7) 基于当前有效日期迭代，而非原始日期；
3. 截断时间部分：用 date.Truncate(24 * time.Hour) 或更推荐的 time.Date(year, month, day, 0, 0, 0, 0, loc) 构造零时区纯日期；
4. 边界控制：循环条件应为 current.Before(endDate) || current.Equal(endDate)，注意语义——2015-10-14 表示“包含该日”，因此结束判断需包含等号。

以下是优化后的完整实现：

func GetDatesByWeekday(startDate, endDate string, targetDay time.Weekday) ([]string, error) {
    const layout = "2006-01-02"
    start, err := time.Parse(layout, startDate)
    if err != nil {
        return nil, fmt.Errorf("parse start date: %w", err)
    }
    end, err := time.Parse(layout, endDate)
    if err != nil {
        return nil, fmt.Errorf("parse end date: %w", err)
    }

    // Step 1: Align start to first target weekday >= start date
    for start.Weekday() != targetDay {
        start = start.AddDate(0, 0, 1)
    }

    var dates []string
    // Step 2: Iterate weekly until exceeding end date (inclusive)
    for !start.After(end) {
        // Step 3: Format as date-only string (no time)
        dates = append(dates, start.Format(layout))
        start = start.AddDate(0, 0, 7)
    }

    return dates, nil
}

// 使用示例：获取 2015-08-17 至 2015-10-14 间所有周日
sundays, _ := GetDatesByWeekday("2015-08-17", "2015-10-14", time.Sunday)
fmt.Println(sundays)
// 输出：[2015-08-23 2015-08-30 2015-09-06 2015-09-13 2015-09-20 2015-09-27 2015-10-04 2015-10-11]

⚠️ 注意事项：

• 时区敏感：time.Parse 默认使用本地时区。若业务跨时区，建议统一使用 time.UTC 或显式指定 loc，并在 ParseInLocation 中传入；
• 性能考量：该方法时间复杂度为 O(n)，n 为区间内目标星期数，适用于常规业务范围（数月到数年），无需额外依赖第三方库；
• 扩展性提示：如需支持“每月第 N 个某星期几”（如“每月第三个周五”），可封装为独立函数，结合 time.Date(year, month, 1, ...) 与 Weekday() 校验实现；
• 数据库写入建议：向 SQL 插入时，优先使用 date 类型字段，并传入 date.Format("2006-01-02") 字符串，或使用 sql.NullTime 配合 Truncate(24*time.Hour) 确保时间部分归零。

总结：Go 原生 time 包已足够支撑健壮的周期日期计算。关键在于理解 Weekday() 对齐逻辑、避免迭代变量误用，并始终以 time.Time 的不可变性思维操作（每次 AddDate 返回新实例）。摒弃多分支 if getDay == 0 { ... } else if getDay == 1 { ... } 的冗余写法，用统一算法替代，显著提升可维护性与可读性。

以上就是《Go 语言生成每周五日期序列方法》的详细内容，更多关于的资料请关注golang学习网公众号！