你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
提供包含日期的周末,如果提供,则按偏移量移动。
一周的最后一天被视为周六。
语法
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 |