介绍

DateBetween是Hutool中用于计算两个日期之间间隔的类，提供了丰富的方法来获取不同时间单位的间隔值，简化了日期差异的计算。

主要功能

1. DateBetween对象的创建

// 创建DateBetween对象
Date start = DateUtil.parse("2023-01-01");
Date end = DateUtil.parse("2023-12-31");
DateBetween between = new DateBetween(start, end);

// 使用DateUtil创建DateBetween
DateBetween between = DateUtil.between(start, end);

// 指定时间单位创建
DateBetween between = DateUtil.between(start, end, DateUnit.DAY);

2. 获取间隔值

// 获取总毫秒数
long totalMs = between.getTotalMilliseconds();

// 获取总秒数
long totalSeconds = between.getTotalSeconds();

// 获取总分钟数
long totalMinutes = between.getTotalMinutes();

// 获取总小时数
long totalHours = between.getTotalHours();

// 获取总天数
long totalDays = between.getTotalDays();

// 获取总月数
long totalMonths = between.getTotalMonths();

// 获取总年数
long totalYears = between.getTotalYears();

3. 按指定单位获取间隔

// 获取按天计算的间隔
long days = between.between(DateUnit.DAY);

// 获取按小时计算的间隔
long hours = between.between(DateUnit.HOUR);

// 获取按分钟计算的间隔
long minutes = between.between(DateUnit.MINUTE);

// 获取按秒计算的间隔
long seconds = between.between(DateUnit.SECOND);

4. 格式化输出

// 格式化输出间隔
String formatted = between.format();
Console.log(formatted); // 输出类似: 364天10小时23分45秒

// 使用自定义格式输出
String customFormatted = between.format("yyyy'年'MM'月'dd'天'H'小时'm'分's'秒'");
Console.log(customFormatted); // 输出类似: 0年11月30天10小时23分45秒

5. 其他常用功能

// 判断是否为正间隔（结束时间大于开始时间）
boolean isPositive = between.isPositive();

// 获取开始时间
Date startDate = between.getStart();

// 获取结束时间
Date endDate = between.getEnd();

// 反向间隔
DateBetween reversed = between.reverse();

适用场景

DateBetween适用于以下场景：

• 需要计算两个日期之间的间隔时
• 需要以不同时间单位获取间隔值时
• 需要格式化输出日期间隔时
• 需要判断日期间隔的正负时

通过DateBetween，开发者可以更加便捷地计算和处理日期间隔，提高代码的可读性和可维护性。