startofmonth()

日付を含む月の始まりが返されます。オフセットが指定されている場合、そのオフセットでシフトされます。

構文

startofmonth(date [,offset ])

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
date	datetime	✔️	月の開始日を検索する日付。
offset	int		入力日からオフセットする月数。 既定値は 0 です。

戻り値

指定された日付値の月の始まりを表すdatetime。指定された場合は、オフセットを使用します。

例

クエリを実行する

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