Freigeben über


startofyear()

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

Syntax

startofyear(Datum [, Offset ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
date datetime ✔️ Das Datum, für das der Anfang des Jahres gefunden werden soll.
offset int Die Anzahl der Jahre, die vom Eingabedatum versetzt werden sollen. Der Standardwert ist 0.

Gibt zurück

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

Beispiel

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

Output

yearStart
2016-01-01 00:00:00.0000000
2017-01-01 00:00:00.0000000
2018-01-01 00:00:00.0000000