Java模拟Oracle函数MONTHS_BETWEEN注意事项

MONTHS_BETWEEN(DATE1, DATE2) 用来计算两个日期的月份差。

最近接到一个迁移需求，把Oracle SQL接口迁移到新平台上，但新平台是采用Java计算的方式，所以我需求把SQL逻辑转成Java语言。

在遇到MONTHS_BETWEEN时，遇到一些奇怪的问题，在此记录一下。

情景在现

一开始，我的大致思路：先计算出两个日期的月份差，再拿开始日期加上月份差再与结束日期计算出日差，如果日差大于0，月份差+1；日差小于0，则月份差-1。

为什么不保留小数？

因为在SQL逻辑中使用到MONTHS_BETWEEN都是用来计算近x个月、未来x个月这类数据，只需要判断是否大于或小于某个整数，所有这里取整是没有问题的（当时是这样想的）。

package com.chen.util;

import lombok.extern.slf4j.Slf4j;

import org.apache.commons.lang3.StringUtils;

import java.text.ParsePosition;

import java.text.SimpleDateFormat;

import java.time.ZoneId;

import java.time.temporal.ChronoUnit;

import java.time.temporal.Temporal;

import java.util.Calendar;

import java.util.Date;

import java.util.Objects;

@Slf4j

public class DateUtil {

    public static final SimpleDateFormat yyyyMMddDateFormat = new SimpleDateFormat("yyyyMMdd");

    public static Date strToDate(String str) {

        if (StringUtils.isBlank(str)) {

            return null;

        }

        return yyyyMMddDateFormat.parse(str, new ParsePosition(0));

    }

    /**

     * 计算两个日期差月份差

     *

     * @param begDate 开始日期

     * @param endDate 结束日期

     * @return 月份差

     */

    public static Integer monthsBetween(Date begDate, Date endDate) {

        try {

            if (Objects.isNull(begDate) || Objects.isNull(endDate)) {

                return null;

            }

            Temporal beg = begDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

            Temporal end = endDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

            int between = (int) ChronoUnit.MONTHS.between(beg, end);

            Calendar calendar = Calendar.getInstance();

            calendar.setTime(begDate);

            calendar.add(Calendar.MONTH, between);

            Date begDateNew = calendar.getTime();

            Temporal begNew = begDateNew.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

            long dayDiff = ChronoUnit.DAYS.between(begNew, end);

            if (dayDiff > 0) {

                between += 1;

            } else if (dayDiff < 0) {

                between -= 1;

            }

            return between;

        } catch (Exception e) {

            log.warn("DateUtil monthsBetweenWithMon() Occurred Exception.", e);

            return null;

        }

    }

    public static void main(String[] args) {

        System.out.printf("%-9s %-9s %-3s\n", "日期1", "日期2", "月份差");

        String date1 = "20240405", date2 = "20240807";

        Integer between = monthsBetween(strToDate(date1), strToDate(date2));

        System.out.printf("%-10s %-10s  %-3s\n", date1, date2, between);

    }

}

结果与Oracle比对

开始日期	结束日期	JAVA	ORACLE
20240405	20240807	5	4.06451612903226
20240715	20240102	-7	-6.41935483870968
20231130	20240131	3	2
20240117	20231224	-1	-0.774193548387097
20240229	20240529	-3	-3
20240229	20240530	-4	-3.03225806451613
20240229	20240531	-4	-3
20240731	20240430	-3	3

结果分析

自测与冒烟测试都没发现问题，正式测试时，发现当两个日期均是月末时，就会导致结果不正确（结果中的20231130与20240131）。

并且还发现Orcale的MONTHS_BETWEEN在处理月末时更是打破常规思维！比如20240731的近3个月应该是从20240501开始计算的；还有一种情况是当两个日期中有一个日期是2月末时，与大月比较29号、30号、31号时，29号与31号的月份差居然是相同的。

查了很多资料最后在ORACLE 日期函数 MONTHS_BETWEEN文章中找到原因。

MONTHS_BETWEEN函数返回两个日期之间的月份数。如果两个日期月份内天数相同，或者都是某个月的最后一天，返回一个整数，否则，返回数值带小数，以每天1/31月来计算月中剩余天数。如果日期1比日期2小，返回值为负数。

问题解决

思路：

日差 = 如果两个日期都是月末，日差为0，否则 (开始日期日 - 结束日期日)

月差 = (开始日期年份 * 12 + 开始日期月份) - (结束日期年份 * 12 + 结束日期月份) + (日差 / 31)

package com.chen.util;

import lombok.extern.slf4j.Slf4j;

import org.apache.commons.lang3.StringUtils;

import java.math.BigDecimal;

import java.math.RoundingMode;

import java.text.ParsePosition;

import java.text.SimpleDateFormat;

import java.time.ZoneId;

import java.time.temporal.ChronoUnit;

import java.time.temporal.Temporal;

import java.util.Calendar;

import java.util.Date;

import java.util.Objects;

@Slf4j

public class DateUtil {

    public static final SimpleDateFormat yyyyMMddDateFormat = new SimpleDateFormat("yyyyMMdd");

    public static Date strToDate(String str) {

        if (StringUtils.isBlank(str)) {

            return null;

        }

        return yyyyMMddDateFormat.parse(str, new ParsePosition(0));

    }

    /**

     * 判断日期是否是月末

     * @param date 日期

     * @return 是否月末

     */

    public static Boolean isEndOfMonth(Calendar date) {

        if (Objects.isNull(date)) {

            return false;

        }

        return date.get(Calendar.DAY_OF_MONTH) == date.getActualMaximum(Calendar.DAY_OF_MONTH);

    }

    /**

     * 适配ORACLE数据库MONTHS_BETWEEN()计算结果

     * MONTHS_BETWEEN(startDate, endDate)

     *

     * @param startDate 开始时间

     * @param endDate   结果时间

     * @return 月份差

     */

    public static BigDecimal oracleMonthsBetween(Date startDate, Date endDate) {

        Calendar startCalendar = Calendar.getInstance();

        startCalendar.setTime(startDate);

        Calendar endCalendar = Calendar.getInstance();

        endCalendar.setTime(endDate);

        int startYear = startCalendar.get(Calendar.YEAR);

        int endYear = endCalendar.get(Calendar.YEAR);

        int startMonth = startCalendar.get(Calendar.MONTH);

        int endMonth = endCalendar.get(Calendar.MONTH);

        int startDay = startCalendar.get(Calendar.DATE);

        int endDay = endCalendar.get(Calendar.DATE);

        // 月份差

        double result = (startYear * 12 + startMonth) - (endYear * 12 + endMonth);

        // 小数月份

        double countDay;

        // 如果是两个日期都是月末，就只处理月份；否则使用日差 / 31 算出小数月份

        if (isEndOfMonth(startCalendar) && isEndOfMonth(endCalendar)) {

            countDay = 0;

        } else {

            countDay = (startDay - endDay) / 31d;

        }

        result += countDay;

        // 返回并保留14位小数位

        return BigDecimal.valueOf(result)

                .setScale(14, RoundingMode.HALF_UP)

                .stripTrailingZeros();

    }

    public static void main(String[] args) {

        System.out.printf("%-9s %-9s %-3s\n", "日期1", "日期2", "月份差");

        String date1 = "20240405", date2 = "20240807";

        BigDecimal between = oracleMonthsBetween(strToDate(date1), strToDate(date2));

        System.out.printf("%-10s %-10s  %-3s\n", date1, date2, between.toPlainString());

    }

}

结果与Oracle比对

开始日期	结束日期	JAVA	ORACLE
20240405	20240807	-4.06451612903226	-4.06451612903226
20240423	20240614	-1.70967741935484	-1.70967741935484
20240229	20240529	-3	-3
20240229	20240530	-3.03225806451613	-3.03225806451613
20240229	20240531	-3	-3
20230228	20230528	-3	-3
20231130	20240131	-2	-2
20231130	20240201	-2.06451612903226	-2.06451612903226
20240731	20240430	3	3
20240731	20240429	3.06451612903226	3.06451612903226
20240430	20240731	-3	-3
20240114	20231010	3.12903225806452	3.12903225806452