endofweek()

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

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

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

Syntax

endofweek( date [, offset])

Learn more about syntax conventions.

Parameters

Name 类型 Required Description
date datetime ✔️ 用于查找周结束时间的日期。
offset int The number of offset weeks from date. 默认为 0。

Returns

Returns datetime representing the end of the week for the given date value, with the offset, if specified.

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