你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

week_of_year()

适用于:✅Microsoft Fabric✅Azure 数据资源管理器Azure MonitorMicrosoft✅ Sentinel

返回一个表示周数的整数。 根据 ISO 8601,周数从一年的第一周(包含一年中第一个周四的那一周)算起。

弃用的别名:weekofyear()

注意

weekofyear() 不符合 ISO 8601;一年的第一周被定义为包含一年中第一个周三的那一周。

语法

week_of_year(date)

详细了解语法约定

参数

客户 类型​​ 必需 描述
date datetime ✔️ 要为其返回年份中的周的日期。

返回

week number - 包含给定日期的周数。

示例

输入 输出
week_of_year(datetime(2020-12-31)) 53
week_of_year(datetime(2020-06-15)) 25
week_of_year(datetime(1970-01-01)) 1
week_of_year(datetime(2000-01-01)) 52

注意

weekofyear() 是此函数的过时变体。 weekofyear() 不符合 ISO 8601;一年的第一周被定义为一年中包含第一个周三的那一周。 函数 week_of_year() 的当前版本符合 ISO 8601;一年的第一周被定义为一年中包含第一个周四的那一周。