package org.dromara.common.core.utils; import org.apache.commons.lang3.time.DateFormatUtils; import org.dromara.common.core.enums.FormatsType; import org.dromara.common.core.exception.ServiceException; import java.lang.management.ManagementFactory; import java.text.ParseException; import java.text.SimpleDateFormat; import java.time.*; import java.util.Date; import java.util.concurrent.TimeUnit; /** * 时间工具类 * * @author ruoyi */ public class DateUtils extends org.apache.commons.lang3.time.DateUtils { private static final String[] PARSE_PATTERNS = { "yyyy-MM-dd", "yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd HH:mm", "yyyy-MM", "yyyy/MM/dd", "yyyy/MM/dd HH:mm:ss", "yyyy/MM/dd HH:mm", "yyyy/MM", "yyyy.MM.dd", "yyyy.MM.dd HH:mm:ss", "yyyy.MM.dd HH:mm", "yyyy.MM"}; @Deprecated private DateUtils() { } /** * 获取当前日期和时间 * * @return 当前日期和时间的 Date 对象表示 */ public static Date getNowDate() { return new Date(); } /** * 获取当前日期的字符串表示,格式为YYYY-MM-DD * * @return 当前日期的字符串表示 */ public static String getDate() { return dateTimeNow(FormatsType.YYYY_MM_DD); } /** * 获取当前日期的字符串表示,格式为yyyyMMdd * * @return 当前日期的字符串表示 */ public static String getCurrentDate() { return DateFormatUtils.format(new Date(), FormatsType.YYYYMMDD.getTimeFormat()); } /** * 获取当前日期的路径格式字符串,格式为"yyyy/MM/dd" * * @return 当前日期的路径格式字符串 */ public static String datePath() { Date now = new Date(); return DateFormatUtils.format(now, FormatsType.YYYY_MM_DD_SLASH.getTimeFormat()); } /** * 获取当前时间的字符串表示,格式为YYYY-MM-DD HH:MM:SS * * @return 当前时间的字符串表示 */ public static String getTime() { return dateTimeNow(FormatsType.YYYY_MM_DD_HH_MM_SS); } /** * 获取当前时间的字符串表示,格式为 "HH:MM:SS" * * @return 当前时间的字符串表示,格式为 "HH:MM:SS" */ public static String getTimeWithHourMinuteSecond() { return dateTimeNow(FormatsType.HH_MM_SS); } /** * 获取当前日期和时间的字符串表示,格式为YYYYMMDDHHMMSS * * @return 当前日期和时间的字符串表示 */ public static String dateTimeNow() { return dateTimeNow(FormatsType.YYYYMMDDHHMMSS); } /** * 获取当前日期和时间的指定格式的字符串表示 * * @param format 日期时间格式,例如"YYYY-MM-DD HH:MM:SS" * @return 当前日期和时间的字符串表示 */ public static String dateTimeNow(final FormatsType format) { return parseDateToStr(format, new Date()); } /** * 将指定日期格式化为 YYYY-MM-DD 格式的字符串 * * @param date 要格式化的日期对象 * @return 格式化后的日期字符串 */ public static String formatDate(final Date date) { return parseDateToStr(FormatsType.YYYY_MM_DD, date); } /** * 将指定日期格式化为 YYYY-MM-DD HH:MM:SS 格式的字符串 * * @param date 要格式化的日期对象 * @return 格式化后的日期时间字符串 */ public static String formatDateTime(final Date date) { return parseDateToStr(FormatsType.YYYY_MM_DD_HH_MM_SS, date); } /** * 将指定日期按照指定格式进行格式化 * * @param format 要使用的日期时间格式,例如"YYYY-MM-DD HH:MM:SS" * @param date 要格式化的日期对象 * @return 格式化后的日期时间字符串 */ public static String parseDateToStr(final FormatsType format, final Date date) { return new SimpleDateFormat(format.getTimeFormat()).format(date); } /** * 将指定格式的日期时间字符串转换为 Date 对象 * * @param format 要解析的日期时间格式,例如"YYYY-MM-DD HH:MM:SS" * @param ts 要解析的日期时间字符串 * @return 解析后的 Date 对象 * @throws RuntimeException 如果解析过程中发生异常 */ public static Date parseDateTime(final FormatsType format, final String ts) { try { return new SimpleDateFormat(format.getTimeFormat()).parse(ts); } catch (ParseException e) { throw new RuntimeException(e); } } /** * 将对象转换为日期对象 * * @param str 要转换的对象,通常是字符串 * @return 转换后的日期对象,如果转换失败或输入为null,则返回null */ public static Date parseDate(Object str) { if (str == null) { return null; } try { return parseDate(str.toString(), PARSE_PATTERNS); } catch (ParseException e) { return null; } } /** * 获取服务器启动时间 * * @return 服务器启动时间的 Date 对象表示 */ public static Date getServerStartDate() { long time = ManagementFactory.getRuntimeMXBean().getStartTime(); return new Date(time); } /** * 计算两个日期之间的天数差(以毫秒为单位) * * @param date1 第一个日期 * @param date2 第二个日期 * @return 两个日期之间的天数差的绝对值 */ public static int differentDaysByMillisecond(Date date1, Date date2) { return Math.abs((int) ((date2.getTime() - date1.getTime()) / (1000 * 3600 * 24))); } /** * 计算两个日期之间的时间差,并以天、小时和分钟的格式返回 * * @param endDate 结束日期 * @param nowDate 当前日期 * @return 表示时间差的字符串,格式为"天 小时 分钟" */ public static String getDatePoor(Date endDate, Date nowDate) { long diffInMillis = endDate.getTime() - nowDate.getTime(); long day = TimeUnit.MILLISECONDS.toDays(diffInMillis); long hour = TimeUnit.MILLISECONDS.toHours(diffInMillis) % 24; long min = TimeUnit.MILLISECONDS.toMinutes(diffInMillis) % 60; return String.format("%d天 %d小时 %d分钟", day, hour, min); } /** * 计算两个时间点的差值(天、小时、分钟、秒),当值为0时不显示该单位 * * @param endDate 结束时间 * @param nowDate 当前时间 * @return 时间差字符串,格式为 "x天 x小时 x分钟 x秒",若为 0 则不显示 */ public static String getTimeDifference(Date endDate, Date nowDate) { long diffInMillis = endDate.getTime() - nowDate.getTime(); long day = TimeUnit.MILLISECONDS.toDays(diffInMillis); long hour = TimeUnit.MILLISECONDS.toHours(diffInMillis) % 24; long min = TimeUnit.MILLISECONDS.toMinutes(diffInMillis) % 60; long sec = TimeUnit.MILLISECONDS.toSeconds(diffInMillis) % 60; // 构建时间差字符串,条件是值不为0才显示 StringBuilder result = new StringBuilder(); if (day > 0) { result.append(String.format("%d天 ", day)); } if (hour > 0) { result.append(String.format("%d小时 ", hour)); } if (min > 0) { result.append(String.format("%d分钟 ", min)); } if (sec > 0) { result.append(String.format("%d秒", sec)); } return result.length() > 0 ? result.toString().trim() : "0秒"; } /** * 将 LocalDateTime 对象转换为 Date 对象 * * @param temporalAccessor 要转换的 LocalDateTime 对象 * @return 转换后的 Date 对象 */ public static Date toDate(LocalDateTime temporalAccessor) { ZonedDateTime zdt = temporalAccessor.atZone(ZoneId.systemDefault()); return Date.from(zdt.toInstant()); } /** * 将 LocalDate 对象转换为 Date 对象 * * @param temporalAccessor 要转换的 LocalDate 对象 * @return 转换后的 Date 对象 */ public static Date toDate(LocalDate temporalAccessor) { LocalDateTime localDateTime = LocalDateTime.of(temporalAccessor, LocalTime.of(0, 0, 0)); ZonedDateTime zdt = localDateTime.atZone(ZoneId.systemDefault()); return Date.from(zdt.toInstant()); } /** * 校验日期范围 * * @param startDate 开始日期 * @param endDate 结束日期 * @param maxValue 最大时间跨度的限制值 * @param unit 时间跨度的单位,可选择 "DAYS"、"HOURS" 或 "MINUTES" */ public static void validateDateRange(Date startDate, Date endDate, int maxValue, TimeUnit unit) { // 校验结束日期不能早于开始日期 if (endDate.before(startDate)) { throw new ServiceException("结束日期不能早于开始日期"); } // 计算时间跨度 long diffInMillis = endDate.getTime() - startDate.getTime(); // 根据单位转换时间跨度 long diff = switch (unit) { case DAYS -> TimeUnit.MILLISECONDS.toDays(diffInMillis); case HOURS -> TimeUnit.MILLISECONDS.toHours(diffInMillis); case MINUTES -> TimeUnit.MILLISECONDS.toMinutes(diffInMillis); default -> throw new IllegalArgumentException("不支持的时间单位"); }; // 校验时间跨度不超过最大限制 if (diff > maxValue) { throw new ServiceException("最大时间跨度为 " + maxValue + " " + unit.toString().toLowerCase()); } } }