package com.ruoyi.inspect.util;
|
|
import java.math.BigDecimal;
|
import java.math.RoundingMode;
|
import java.util.Objects;
|
import java.util.regex.Pattern;
|
|
/**
|
* 时分时间差计算工具类
|
* 支持格式：HH:mm（24小时制），如 08:30、23:59、00:00
|
*/
|
public class HourDiffCalculator {
|
|
// 校验HH:mm格式的正则（24小时制，小时00-23，分钟00-59）
|
private static final Pattern TIME_PATTERN = Pattern.compile("^([01]?[0-9]|2[0-3]):[0-5][0-9]$");
|
|
/**
|
* 计算两个时分字符串之间的相隔小时数
|
* @param startTime 开始时间（HH:mm，如 "08:30"）
|
* @param endTime 结束时间（HH:mm，如 "17:45"）
|
* @return 相隔小时数（保留2位小数，如 9.25 小时）
|
* @throws IllegalArgumentException 时间格式错误时抛出异常
|
*/
|
public static double getHourDiff(String startTime, String endTime) {
|
// 1. 校验时间格式
|
validateTimeFormat(startTime);
|
validateTimeFormat(endTime);
|
|
// 2. 解析时分字符串为总分钟数
|
int startMinutes = convertTimeToMinutes(startTime);
|
int endMinutes = convertTimeToMinutes(endTime);
|
|
// 3. 计算分钟差
|
int minuteDiff = endMinutes - startMinutes;
|
|
// 4. 转换为小时数（保留2位小数，避免精度丢失）
|
BigDecimal hourDiff = new BigDecimal(minuteDiff)
|
.divide(new BigDecimal(60), 2, RoundingMode.HALF_UP);
|
return hourDiff.doubleValue();
|
}
|
|
/**
|
* 校验时间格式是否为HH:mm
|
*/
|
private static void validateTimeFormat(String time) {
|
if (time == null || !TIME_PATTERN.matcher(time).matches()) {
|
throw new IllegalArgumentException("时间格式错误，需为HH:mm（24小时制）：" + time);
|
}
|
}
|
|
/**
|
* 将HH:mm字符串转换为总分钟数（如 08:30 → 510 分钟）
|
*/
|
private static int convertTimeToMinutes(String time) {
|
String[] parts = time.split(":");
|
int hour = Integer.parseInt(parts[0]);
|
int minute = Integer.parseInt(parts[1]);
|
return hour * 60 + minute;
|
}
|
|
}
|
