New template functions `ISOYear`, `ISOMonth` and `ISOWeekDate`

[Achuan-2]

新增模板函数ISOYear和ISOMonth

In what scenarios do you need this feature?

按 ISOweek，2025 年只有 52 周，12 月 28 日是周日，12 月 29 日就算是 2026 年的第一周了
如果周记模板选择/daily note/{{now | date "2006/01"}}/{{now | date "2006"}}W{{now | ISOWeek}}，在2025年12月29日创建的周记标题会变为“2025W1”

Describe the optimal solution

希望新增一个模板函数，可以自动获取ISOYear，这样创建周记时，可以自动获取年份

参考：https://www.alibabacloud.com/help/tc/maxcompute/user-guide/isoyear

Describe the candidate solution

No response

Other information

No response

[Achuan-2]

另外动态图标展示周数图标时也要显示ISOYear：#15680

[Achuan-2]

此外还希望新增ISOMonth，因为有些用户的周记是希望放在月份文件夹里的，目前跨月的周，也需要改进下所属月份判断，根据周一是在本月还是上个月判断周所属的月份

[88250]

代码是 AI 生成的，麻烦帮忙评审，谢谢。

[Achuan-2]

ISOMonth有问题：

• 2025-08-27，应该返回8
• 2025-09-01，应该返回9

现在都返回7

[Achuan-2]

我让claude写的代码目前测试正常

package main

import (
	"fmt"
	"strings"
	"time"
)

// ISOMonth 返回指定时间所在 ISO 周的月份数字
// 以每周的第一天（周一）落在的月份作为整周的月份
func ISOMonth(t time.Time) int {
	// 获取当前时间是周几 (Go中: 周日=0, 周一=1, ..., 周六=6)
	weekday := int(t.Weekday())

	// 转换为 ISO 标准 (周一=1, 周二=2, ..., 周日=7)
	if weekday == 0 {
		weekday = 7
	}

	// 计算距离本周一的天数
	daysToMonday := weekday - 1

	// 计算本周一的日期
	monday := t.AddDate(0, 0, -daysToMonday)

	// 返回周一所在的月份
	return int(monday.Month())
}

func main() {
	// 测试用例
	testDates := []string{
		"2025-08-01", // 应该返回 7 (周五，本周一是7月28日)
		"2025-08-27", // 应该返回 8 (周三，本周一是8月25日)
		"2025-09-01", // 应该返回 9 (周一，就是9月1日)
		"2025-07-28", // 周一，7月
		"2025-08-03", // 周日，本周一是7月28日
		"2025-08-25", // 周一，8月
		"2025-08-31", // 周日，本周一是8月25日
	}

	fmt.Println("ISOMonth 函数测试:")
	fmt.Println("日期\t\t周几\t本周一\t\tISO月份")
	fmt.Println(strings.Repeat("-", 60))

	weekdayNames := []string{"周日", "周一", "周二", "周三", "周四", "周五", "周六"}

	for _, dateStr := range testDates {
		date, _ := time.Parse("2006-01-02", dateStr)
		isoMonth := ISOMonth(date)

		// 计算本周一的日期用于显示
		weekday := int(date.Weekday())
		if weekday == 0 {
			weekday = 7
		}
		monday := date.AddDate(0, 0, -(weekday - 1))

		fmt.Printf("%s\t%s\t%s\t%d\n",
			dateStr,
			weekdayNames[date.Weekday()],
			monday.Format("2006-01-02"),
			isoMonth)
	}

	// 验证特定的测试用例
	fmt.Println("\n验证特定测试用例:")

	// 测试 2025-08-01
	date1, _ := time.Parse("2006-01-02", "2025-08-01")
	result1 := ISOMonth(date1)
	fmt.Printf("2025-08-01 -> %d (期望: 7) %s\n", result1, checkResult(result1, 7))

	// 测试 2025-08-27
	date2, _ := time.Parse("2006-01-02", "2025-08-27")
	result2 := ISOMonth(date2)
	fmt.Printf("2025-08-27 -> %d (期望: 8) %s\n", result2, checkResult(result2, 8))

	// 测试 2025-09-01
	date3, _ := time.Parse("2006-01-02", "2025-09-01")
	result3 := ISOMonth(date3)
	fmt.Printf("2025-09-01 -> %d (期望: 9) %s\n", result3, checkResult(result3, 9))
}

func checkResult(actual, expected int) string {
	if actual == expected {
		return "✅"
	}
	return "❌"
}

在线测试：https://go.dev/play/

[88250]

感谢，稍后改成你提供的这个实现。