startofmonth()

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

语法

startofmonth(date [,offset ])

详细了解语法约定

参数

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

返回

表示给定“日期”值的月份开始的日期/时间(带偏移量,如果指定了的话)。

示例

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

输出

monthStart
2016-12-01 00:00:00.0000000
2017-01-01 00:00:00.0000000
2017-02-01 00:00:00.0000000