endofweek()

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息
适用于:✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

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

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

Syntax

endofweek( date [, offset])

详细了解语法约定

Parameters

Name 类型 Required Description
date datetime ✔️ 用于查找周结束时间的日期。
offset int 从 date 开始的偏移周数。 默认为 0。

Returns

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

Examples

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

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

Output

weekEnd
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', 8, 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)

Output

Date day SundayEndOfWeek
2025-06-14 00:00:00.0000000 Saturday 2025-06-15 23:59:59.9999999
2025-06-15 00:00:00.0000000 Sunday 2025-06-15 23:59:59.9999999
2025-06-16 00:00:00.0000000 Monday 2025-06-22 23:59:59.9999999
2025-06-17 00:00:00.0000000 Tuesday 2025-06-22 23:59:59.9999999