startofmonth()startofmonth()

返回包含日期的一月的起点,根据偏移量移动(如提供)。Returns the start of the month containing the date, shifted by an offset, if provided.

语法Syntax

startofmonth(date [,offset ])startofmonth(date [,offset ])

参数Arguments

  • date:输入日期。date: The input date.
  • offset:输入日期中的可选偏移月数(整数,默认值为 0)。offset: An optional number of offset months from the input date (integer, default - 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) 
monthStartmonthStart
2016-12-01 00:00:00.00000002016-12-01 00:00:00.0000000
2017-01-01 00:00:00.00000002017-01-01 00:00:00.0000000
2017-02-01 00:00:00.00000002017-02-01 00:00:00.0000000