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 |