startofyear()

Возвращает начало года, содержащее дату, сдвинутую на смещение, если оно предусмотрено.

Синтаксис

startofyear(date [,offset ])

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
date datetime ✔️ Дата начала года.
offset int Число лет, которые необходимо смещать от входной даты. Значение по умолчанию равно 0.

Возвращаемое значение

Дата и время, представляющее начало года для заданного значения даты со смещением, если указано.

Пример

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

Выходные данные

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