在Go语言的时间处理场景中，从ISO年周获取对应周一零点时间戳是很多业务会遇到的需求，比如按周统计数据、生成周维度的报表等。ISO年周遵循ISO 8601标准，和常规的公历周计算规则存在差异，需要特别注意。
ISO年周的核心规则
ISO 8601标准对年周的定义有几个关键规则，理解这些规则才能准确计算时间戳：
- 每年的第一周是包含该年第一个星期四的那一周，也就是说这一周至少有4天属于新的一年
- 周一是一周的第一天，周日是一周的最后一天
- ISO周的年份可能和公历年份不同，比如某一天的ISO周年份可能是前一年或者后一年
Go语言标准库的时间处理方法
Go语言的time包提供了丰富的时间处理功能，其中和本次需求相关的核心方法包括：
time.Date：构造指定年月日的时间对象time.Weekday：获取时间是周几，返回值是time.Weekday类型，周一到周日对应1到7time.Time.Truncate：将时间截断到指定的精度，比如截断到天可以得到零点时间
具体实现步骤
从ISO年周获取周一零点时间戳的整体思路是：先找到该ISO年周对应的周一的日期，再将该日期的时间设置为零点，最后转换为时间戳。具体步骤如下：
步骤1：找到ISO年第一周的第一天
ISO年的第一周是包含第一个星期四的周，我们可以先找到该年1月4日，因为1月4日肯定在第一周里，再根据1月4日的周几反推第一周的周一日期。
步骤2：计算目标周对应的周一日期
已知第一周的周一日期后，加上（目标周数-1）*7天，就可以得到目标周的周一日期。
步骤3：将时间截断到零点并获取时间戳
将得到的周一日期的时间设置为零点，再调用Unix方法获取时间戳即可。
完整代码示例
下面是封装好的工具函数，输入ISO年份和周数，返回对应周一零点的时间戳：
package main
import (
"fmt"
"time"
)
// GetMondayTimestampFromISOWeek 从ISO年周获取周一零点时间戳
// isoYear: ISO年份
// isoWeek: ISO周数，范围是1-53
// 返回对应周一零点的Unix时间戳，若周数不合法返回错误
func GetMondayTimestampFromISOWeek(isoYear int, isoWeek int) (int64, error) {
// 校验周数范围，ISO周数最多53周
if isoWeek < 1 || isoWeek > 53 {
return 0, fmt.Errorf("invalid iso week: %d, should be between 1 and 53", isoWeek)
}
// 找到该年1月4日，因为1月4日一定在ISO第一周里
jan4 := time.Date(isoYear, time.January, 4, 0, 0, 0, 0, time.UTC)
// 获取1月4日是周几，time.Weekday中Sunday是0，Monday是1，所以需要转换
// 计算第一周周一的日期：如果1月4日是周一，那第一周周一就是1月4日减去0天；如果是周二，减去1天，以此类推
// 先得到1月4日的周几数值，Monday是1，Sunday是7
weekday := int(jan4.Weekday())
if weekday == 0 {
weekday = 7
}
// 第一周周一 = 1月4日 - (weekday - 1)天
firstWeekMonday := jan4.AddDate(0, 0, -(weekday - 1))
// 计算目标周的周一：第一周周一 + (isoWeek-1)*7天
targetMonday := firstWeekMonday.AddDate(0, 0, (isoWeek-1)*7)
// 截断到零点，确保时间是00:00:00
targetMondayZero := targetMonday.Truncate(24 * time.Hour)
// 返回时间戳
return targetMondayZero.Unix(), nil
}
func main() {
// 测试示例：获取ISO 2024年第1周的周一零点时间戳
timestamp, err := GetMondayTimestampFromISOWeek(2024, 1)
if err != nil {
fmt.Printf("get timestamp error: %vn", err)
return
}
fmt.Printf("ISO 2024 week 1 Monday zero timestamp: %dn", timestamp)
// 转换回时间对象验证
t := time.Unix(timestamp, 0).UTC()
fmt.Printf("corresponding time: %d-%02d-%02d 00:00:00 UTCn", t.Year(), t.Month(), t.Day())
// 测试ISO 2023年第52周的周一
ts2, err := GetMondayTimestampFromISOWeek(2023, 52)
if err != nil {
fmt.Printf("get timestamp error: %vn", err)
return
}
t2 := time.Unix(ts2, 0).UTC()
fmt.Printf("ISO 2023 week 52 Monday zero time: %d-%02d-%02d 00:00:00 UTCn", t2.Year(), t2.Month(), t2.Day())
}
注意事项
- 时区问题：上述代码使用UTC时区计算，如果业务需要使用其他时区，可以在构造时间对象时传入对应的时区信息，比如
time.FixedZone或者加载系统时区 - 周数校验：ISO周数最多是53周，所以需要校验输入的周数是否在合法范围，避免计算错误
- 边界情况：当ISO周对应的日期跨公历年份时，计算逻辑仍然适用，因为第一周周一的计算已经遵循了ISO标准，不会出现年份偏差
需要注意，time.Time.ISOWeek方法可以直接获取时间对应的ISO年份和周数，如果需要反向验证计算结果，可以使用该方法做校验。