startofyear()

返回包含日期的年份的起点,偏移某个偏移量(如已提供)。

语法

startofyear(date [,offset ])

详细了解语法约定

参数

客户 类型​​ 必需 描述
date datetime 要查找其所对应年份的开始时间的日期。
offset int 从输入日期偏移的年数。 默认值为 0。

返回

一个日期/时间,表示给定 date 值的那一年的开始(如果指定了偏移量,则还包含该信息)。

示例

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