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

endofweek()

适用于:✅Azure 数据资源管理器Azure Monitor✅ Sentinel

提供包含日期的周末,如果提供,则按偏移量移动。

一周的最后一天被视为周六。

语法

endofweek( date [, offset])

详细了解语法约定

参数

客户 类型​​ 必需 描述
日期 datetime ✔️ 用于查找周结束时间的日期。
抵消 int 从 date 开始的偏移周数。 默认为 0。

返回

返回表示给定 日期 值的周结束日期时间(如果指定)。如果指定,则返回 偏移量

例子

以下示例返回指定日期的周结束时间。

  range offset from -1 to 1 step 1
 | project weekEnd = endofweek(datetime(2017-01-01 10:10:17), offset)  

输出

周末
2016-12-31 23:59:59.9999999
2017-01-07 23:59:59.9999999
2017-01-14 23:59:59.9999999

以下示例将周末作为指定日期的星期日返回。

let endofweekSunday = (dateArg: datetime) {
    datetime_add('day', 1, endofweek(datetime_add('day', -8, dateArg)))
};
let data=datatable(Date: datetime, day: string)
[
datetime(2025, 6, 14), "Saturday",
datetime(2025, 6, 15), "Sunday",
datetime(2025, 6, 16), "Monday",
datetime(2025, 6, 17), "Tuesday"
];
data 
| extend SundayEndOfWeek=endofweekSunday(Date)

输出

日期 SundayEndOfWeek
2025-06-14 00:00:00.0000000 星期六 2025-06-08 23:59:59.9999999
2025-06-15 00:00:00.0000000 星期日 2025-06-08 23:59:59.9999999
2025-06-16 00:00:00.0000000 星期一 2025-06-15 23:59:59.9999999
2025-06-17 00:00:00.0000000 星期二 2025-06-15 23:59:59.9999999