本文介绍如何在 go 语言中精准、安全地计算任意 time.time 对象所在年份的第一天（1月1日 00:00:00）和最后一天（12月31日 00:00:00）的时间戳，避免手动计算天数导致的闰年、时区等错误。
本文介绍如何在 go 语言中精准、安全地计算任意 time.time 对象所在年份的第一天（1月1日 00:00:00）和最后一天（12月31日 00:00:00）的时间戳，避免手动计算天数导致的闰年、时区等错误。
在 Go 中，若需获取某时间点所在年份的起止时刻，最可靠的方式是使用 time.Date 构造函数，而非基于 YearDay() 和 AddDate() 的偏移计算——后者易受闰年（如 2024 年有 366 天）、时区夏令时切换或跨年边界影响，逻辑脆弱且难以维护。
time.Date 允许你显式指定年、月、日、时、分、秒、纳秒及时区，Go 运行时会自动处理合法性校验（例如自动将 2023, December, 31 视为有效日期，而 2023, February, 30 会归一化为 3 月 2 日）。因此，获取年首与年尾的标准做法如下：
- 年首时间：time.Date(t.Year(), time.January, 1, 0, 0, 0, 0, t.Location())
- 年尾时间：time.Date(t.Year(), time.December, 31, 0, 0, 0, 0, t.Location())
注意：应使用原时间 t 的时区（t.Location()），而非硬编码 time.UTC，以确保语义一致。例如，若 t 是 Asia/Shanghai 时区的 2024-06-15 14:30:00，则年首应为 2024-01-01 00:00:00 +0800，而非 2024-01-01 00:00:00 UTC。
以下是完整可运行示例：
package main
import (
"fmt"
"time"
)
func YearStartEnd(t time.Time) (first, last time.Time) {
year := t.Year()
loc := t.Location()
return time.Date(year, time.January, 1, 0, 0, 0, 0, loc),
time.Date(year, time.December, 31, 0, 0, 0, 0, loc)
}
func main() {
t := time.Now()
first, last := YearStartEnd(t)
fmt.Printf("Current: %s\n", t.Format("2006-01-02 15:04:05 MST"))
fmt.Printf("First day: %s\n", first.Format("2006-01-02 15:04:05 MST"))
fmt.Printf("Last day: %s\n", last.Format("2006-01-02 15:04:05 MST"))
}
✅ 关键优势说明：
- ✅ 闰年无关：time.Date(2024, December, 31, ...) 自动适配 366 天年份，无需额外判断；
- ✅ 时区安全：复用 t.Location()，保留原始上下文；
- ✅ 零依赖：仅使用标准库 time 包，无第三方引入；
- ✅ 可读性强：语义清晰，意图一目了然。
⚠️ 注意事项：
- 若需获取「年末最后一秒」（即 23:59:59.999999999），请将秒/纳秒字段设为 23, 59, 59, 999999999；但通常业务场景中「年尾」指 12月31日 00:00:00（含该时刻起至次年首时刻前的所有时间），因此默认使用 00:00:00 更符合时间区间定义习惯；
- 不建议使用 t.AddDate(0, 0, -t.YearDay()+1) 等算术方式推导年首——YearDay() 返回的是当年第几天（1–366），但 AddDate 在跨月/跨年时可能因时区规则产生意外结果（如夏令时切换导致小时偏移）。
综上，time.Date 是 Go 中处理日期边界问题的事实标准方案。掌握这一模式，不仅能解决年首年末需求，还可轻松扩展至季度、月份起止、指定周的周一/周日等场景。
