Freigeben über


startofweek()

Gilt für: ✅Microsoft Fabric

Gibt den Beginn der Woche zurück, die das Datum enthält (verschoben um einen Offset, sofern angegeben).

Beginn der Woche gilt als Sonntag.

Syntax

startofweek( Datum [,Offset ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich Beschreibung
Datum datetime ✔️ Das Datum, für das der Anfang der Woche gefunden werden soll.
Offset int Die Anzahl der Wochen, die vom Eingabedatum versetzt werden sollen. Der Standardwert ist 0.

Gibt zurück

Eine Datumszeit, die den Anfang der Woche für den angegebenen Datumswert darstellt, mit dem Offset, sofern angegeben.

Beispiele

range offset from -1 to 1 step 1
| project weekStart = startofweek(datetime(2017-01-01 10:10:17), offset) 

Ausgabe

weekStart
2016-12-25 00:00:00.0000000
2017-01-01 00:00:00.0000000
2017-01-08 00:00:00.0000000

Im folgenden Beispiel wird der Wochenanfang für das angegebene Datum als Montag zurückgegeben.

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)

Ausgabe

Datum Tag MontagWoche
2025-06-14 00:00:00.0000000 Samstag 2025-06-09 00:00:00.0000000
2025-06-15 00:00:00.0000000 Sonntag 2025-06-09 00:00:00.0000000
2025-06-16 00:00:00.0000000 Montag 2025-06-16 00:00:00.0000000
2025-06-17 00:00:00.0000000 Dienstag 2025-06-16 00:00:00.0000000