你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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