Edit

startofyear()

  • Article

Returns the start of the year containing the date, shifted by an offset, if provided.

Syntax

startofyear(date [, offset ])

Learn more about syntax conventions.

Parameters

Name Type Required Description
date datetime ✔️ The date for which to find the start of the year.
offset int The number of years to offset from the input date. The default is 0.

Returns

A datetime representing the start of the year for the given date value, with the offset, if specified.

Example

Run the query

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