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

startofmonth()

Applies to: ✅ Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Returns the start of the month containing the date, shifted by an offset, if provided.

Syntax

startofmonth(date [, offset ])

Learn more about syntax conventions.

Parameters

Name Type Required Description
date datetime ✔️ The date for which to find the start of month.
offset int The number of months to offset from the input date. The default is 0.

Returns

A datetime representing the start of the month for the given date value, with the offset, if specified.

Example

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

Output

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