Share via


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 Typ Erforderlich BESCHREIBUNG
date datetime ✔️ Das Datum, für das der Jahresbeginn ermittelt werden soll.
offset int Die Anzahl der Jahre, die vom Eingabedatum abgesetzt werden sollen. Die Standardeinstellung ist 0.

Gibt zurück

Eine datetime, die den Jahresanfang 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) 

Ausgabe

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