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;@Slf4jpublic 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比对
开始日期结束日期JAVAORACLE202404052024080754.064516129032262024071520240102-7-6.419354838709682023113020240131322024011720231224-1-0.7741935483870972024022920240529-3-32024022920240530-4-3.032258064516132024022920240531-4-32024073120240430-33结果分析
自测与冒烟测试都没发现问题，正式测试时，发现当两个日期均是月末时，就会导致结果不正确（结果中的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;@Slf4jpublic 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比对
开始日期结束日期JAVAORACLE2024040520240807-4.06451612903226-4.064516129032262024042320240614-1.70967741935484-1.709677419354842024022920240529-3-32024022920240530-3.03225806451613-3.032258064516132024022920240531-3-32023022820230528-3-32023113020240131-2-22023113020240201-2.06451612903226-2.0645161290322620240731202404303320240731202404293.064516129032263.064516129032262024043020240731-3-320240114202310103.129032258064523.12903225806452
页:
[1]