適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
日付を含む週の始まりが返されます。オフセットが指定されている場合、そのオフセットでシフトされます。
週の始まりは日曜日と見なされています。
構文
startofweek(
date [,
offset ])
構文規則について詳しく知る。
パラメーター
件名 | タイプ | 必須 | 内容 |
---|---|---|---|
日付 | datetime |
✔️ | 週の始まりを検索する日付。 |
オフセット | int |
入力日からオフセットする週数。 既定値は 0 です。 |
返品
指定された date 値の週の始まりを表す datetime 値。オフセットが指定された場合はその値を加えます。
例示
range offset from -1 to 1 step 1
| project weekStart = startofweek(datetime(2017-01-01 10:10:17), offset)
出力
weekStart |
---|
2016-12-25 00:00:00.0000000 |
2017-01-01 00:00:00.0000000 |
2017-01-08 00:00:00.0000000 |
次の例では、指定した日付の週の始まりを月曜日として返します。
let startofweekFromMonday = (dateArg: datetime) {
datetime_add('day', 1, startofweek(datetime_add('day', -1, 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 MondayWeek=startofweekFromMonday(Date)
出力
日付 | 日 | MondayWeek |
---|---|---|
2025-06-14 00:00:00.0000000 | 土曜日 | 2025-06-09 00:00:00.0000000 |
2025-06-15 00:00:00.0000000 | 日曜日 | 2025-06-09 00:00:00.0000000 |
2025-06-16 00:00:00.0000000 | 月曜日 | 2025-06-16 00:00:00.0000000 |
2025-06-17 00:00:00.0000000 | 火曜日 | 2025-06-16 00:00:00.0000000 |