跳到主要内容

MONTHS_DIFF

描述

MONTHS_DIFF 函数用于计算两个日期之间相差的月份数。该函数接受两个日期参数,返回第一个日期减去第二个日期后的相差月份数。

语法

MONTHS_DIFF(<enddate>, <startdate>)

参数

参数说明
<enddate>结束日期,表示计算差值时的较晚日期。支持日期类型(如 DATE)或日期时间类型(如 DATETIME
<startdate>开始日期,表示计算差值时的较早日期。支持日期类型(如 DATE)或日期时间类型(如 DATETIME

返回值

返回 <enddate> 减去 <startdate> 所得月份数

  • <enddate><startdate>任意为NULL,或者两者都为NULL时,返回NULL

举例

select months_diff('2020-12-25','2020-10-25'),months_diff('2020-10-25 10:00:00','2020-12-25 11:00:00');
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+
| months_diff(cast('2020-12-25' as DATETIMEV2(0)), cast('2020-10-25' as DATETIMEV2(0))) | months_diff(cast('2020-10-25 10:00:00' as DATETIMEV2(0)), cast('2020-12-25 11:00:00' as DATETIMEV2(0))) |
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+
| 2 | -2 |
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+