MONTH_FLOOR
更新时间：2025-10-17
描述
将日期时间值向下取整到最近的指定月份周期。如果指定了起始时间（origin），则以该时间为基准计算周期。
语法
SQL
1MONTH_FLOOR(<datetime>)
2MONTH_FLOOR(<datetime>, <origin>)
3MONTH_FLOOR(<datetime>, <period>)
4MONTH_FLOOR(<datetime>, <period>, <origin>)参数
| 参数 | 说明 |
|---|---|
<datetime> |
需要向下取整的日期时间值，类型为 DATETIME 或 DATETIMEV2 |
<period> |
月份周期值，类型为 INT，表示每个周期包含的月数 |
<origin> |
周期的起始时间点，类型为 DATETIME 或 DATETIMEV2，默认值为 0001-01-01 00:00:00 |
返回值
返回类型为 DATETIME，表示向下取整后的日期时间值。结果的时间部分将被设置为 00:00:00。
举例
SQL
1SELECT MONTH_FLOOR("2023-07-13 22:28:18", 5);
Text
1+--------------------------------------------------------------+
2| month_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
3+--------------------------------------------------------------+
4| 2023-05-01 00:00:00 |
5+--------------------------------------------------------------+注意：
- 不指定 period 时，默认以 1 个月为周期
- period 必须为正整数
- 结果总是向过去时间取整
- 返回值的时间部分总是 00:00:00
- 与 MONTH_CEIL 相反，MONTH_FLOOR 总是舍去超出周期的部分