GLibDateTimeget_week_numbering_year

返回包含 datetime 的周所对应的 ISO 8601 年份数。

此函数与 g_date_time_get_week_of_year() 和 g_date_time_get_day_of_week() 一起使用，可以确定 datetime 落在的完整 ISO 周日期。

这通常等于正常的格里高利年（如通过 g_date_time_get_year() 返回的），但如以下所述

对于星期四，周序数年份始终等于通常的日历年份。对于其他日子，数字是这样的，一个完整的星期（从星期一到星期日）内的每一天都包含在同一个周序数年份中。

对于年末接近星期一、星期二和星期三，这意味着周序数年份可能比日历年份大一年（因此这些日子与下一年初出现的星期四拥有相同的周序数年份）。

对于年初接近星期五、星期六和星期日，这意味着周序数年份可能比日历年份小一年（因此这些日子与上一年末出现的星期四拥有相同的周序数年份）。

一个等效的描述是，周序数年份等于包含当前星期（星期一到星期日）大多数日的日历年份。

请注意，公元 0001 年 1 月 1 日在拟推断的格里高利历中是星期一，因此此函数永远不会返回 0。

自 2.26 起可用