startofyear()

返回包含日期的一年的起点,根据偏移量移动(如提供)。

语法

startofyear(date [,offset ])

参数

  • date:输入日期。
  • offset:输入日期(整数,默认值为 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