Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Switch services using the Version drop-down list. Learn more about navigation.
Applies to: ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel
Returns the start of the week containing the date, shifted by an offset, if provided.
Start of the week is considered to be a Sunday.
Syntax
startofweek(date [, offset ])
Learn more about syntax conventions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| date | datetime |
✔️ | The date for which to find the start of week. |
| offset | int |
The number of weeks to offset from the input date. The default is 0. |
Returns
A datetime representing the start of the week for the given date value, with the offset, if specified.
Examples
range offset from -1 to 1 step 1
| project weekStart = startofweek(datetime(2017-01-01 10:10:17), offset)
Output
| weekStart |
|---|
| 2016-12-25 00:00:00.0000000 |
| 2017-01-01 00:00:00.0000000 |
| 2017-01-08 00:00:00.0000000 |
The following example returns the start of the week as Monday for the specified date.
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)
Output
| Date | day | MondayWeek |
|---|---|---|
| 2025-06-14 00:00:00.0000000 | Saturday | 2025-06-09 00:00:00.0000000 |
| 2025-06-15 00:00:00.0000000 | Sunday | 2025-06-09 00:00:00.0000000 |
| 2025-06-16 00:00:00.0000000 | Monday | 2025-06-16 00:00:00.0000000 |
| 2025-06-17 00:00:00.0000000 | Tuesday | 2025-06-16 00:00:00.0000000 |