提供包含日期的周末,如果提供,则按偏移量移动。
一周的最后一天被视为周六。
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 |