| 提交 | 用户 | 时间 | ||
| e7c126 | 1 | package com.iailab.framework.common.util.date; |
| H | 2 | |
| 3 | import cn.hutool.core.collection.CollUtil; | |
| 4 | import cn.hutool.core.date.DatePattern; | |
| 5 | import cn.hutool.core.date.LocalDateTimeUtil; | |
| 6 | import cn.hutool.core.lang.Assert; | |
| 7 | import cn.hutool.core.util.StrUtil; | |
| 8 | import com.iailab.framework.common.enums.DateIntervalEnum; | |
| 9 | ||
| 10 | import java.time.*; | |
| 11 | import java.time.format.DateTimeParseException; | |
| 12 | import java.time.temporal.ChronoUnit; | |
| 13 | import java.time.temporal.TemporalAdjusters; | |
| 14 | import java.util.ArrayList; | |
| 15 | import java.util.List; | |
| 16 | ||
| 17 | /** | |
| 18 | * 时间工具类，用于 {@link java.time.LocalDateTime} | |
| 19 | * | |
| 20 | * @author iailab | |
| 21 | */ | |
| 22 | public class LocalDateTimeUtils { | |
| 23 | ||
| 24 | /** | |
| 25 | * 空的 LocalDateTime 对象，主要用于 DB 唯一索引的默认值 | |
| 26 | */ | |
| 27 | public static LocalDateTime EMPTY = buildTime(1970, 1, 1); | |
| 28 | ||
| 29 | /** | |
| 30 | * 解析时间 | |
| 31 | * | |
| 32 | * 相比 {@link LocalDateTimeUtil#parse(CharSequence)} 方法来说，会尽量去解析，直到成功 | |
| 33 | * | |
| 34 | * @param time 时间 | |
| 35 | * @return 时间字符串 | |
| 36 | */ | |
| 37 | public static LocalDateTime parse(String time) { | |
| 38 | try { | |
| 39 | return LocalDateTimeUtil.parse(time, DatePattern.NORM_DATE_PATTERN); | |
| 40 | } catch (DateTimeParseException e) { | |
| 41 | return LocalDateTimeUtil.parse(time); | |
| 42 | } | |
| 43 | } | |
| 44 | ||
| 45 | public static LocalDateTime addTime(Duration duration) { | |
| 46 | return LocalDateTime.now().plus(duration); | |
| 47 | } | |
| 48 | ||
| 49 | public static LocalDateTime minusTime(Duration duration) { | |
| 50 | return LocalDateTime.now().minus(duration); | |
| 51 | } | |
| 52 | ||
| 53 | public static boolean beforeNow(LocalDateTime date) { | |
| 54 | return date.isBefore(LocalDateTime.now()); | |
| 55 | } | |
| 56 | ||
| 57 | public static boolean afterNow(LocalDateTime date) { | |
| 58 | return date.isAfter(LocalDateTime.now()); | |
| 59 | } | |
| 60 | ||
| 61 | /** | |
| 62 | * 创建指定时间 | |
| 63 | * | |
| 64 | * @param year 年 | |
| 65 | * @param mouth 月 | |
| 66 | * @param day 日 | |
| 67 | * @return 指定时间 | |
| 68 | */ | |
| 69 | public static LocalDateTime buildTime(int year, int mouth, int day) { | |
| 70 | return LocalDateTime.of(year, mouth, day, 0, 0, 0); | |
| 71 | } | |
| 72 | ||
| 73 | public static LocalDateTime[] buildBetweenTime(int year1, int mouth1, int day1, | |
| 74 | int year2, int mouth2, int day2) { | |
| 75 | return new LocalDateTime[]{buildTime(year1, mouth1, day1), buildTime(year2, mouth2, day2)}; | |
| 76 | } | |
| 77 | ||
| 78 | /** | |
| 79 | * 判指定断时间，是否在该时间范围内 | |
| 80 | * | |
| 81 | * @param startTime 开始时间 | |
| 82 | * @param endTime 结束时间 | |
| 83 | * @param time 指定时间 | |
| 84 | * @return 是否 | |
| 85 | */ | |
| 86 | public static boolean isBetween(LocalDateTime startTime, LocalDateTime endTime, String time) { | |
| 87 | if (startTime == null || endTime == null || time == null) { | |
| 88 | return false; | |
| 89 | } | |
| 90 | return LocalDateTimeUtil.isIn(parse(time), startTime, endTime); | |
| 91 | } | |
| 92 | ||
| 93 | /** | |
| 94 | * 判断当前时间是否在该时间范围内 | |
| 95 | * | |
| 96 | * @param startTime 开始时间 | |
| 97 | * @param endTime 结束时间 | |
| 98 | * @return 是否 | |
| 99 | */ | |
| 100 | public static boolean isBetween(LocalDateTime startTime, LocalDateTime endTime) { | |
| 101 | if (startTime == null || endTime == null) { | |
| 102 | return false; | |
| 103 | } | |
| 104 | return LocalDateTimeUtil.isIn(LocalDateTime.now(), startTime, endTime); | |
| 105 | } | |
| 106 | ||
| 107 | /** | |
| 108 | * 判断当前时间是否在该时间范围内 | |
| 109 | * | |
| 110 | * @param startTime 开始时间 | |
| 111 | * @param endTime 结束时间 | |
| 112 | * @return 是否 | |
| 113 | */ | |
| 114 | public static boolean isBetween(String startTime, String endTime) { | |
| 115 | if (startTime == null || endTime == null) { | |
| 116 | return false; | |
| 117 | } | |
| 118 | LocalDate nowDate = LocalDate.now(); | |
| 119 | return LocalDateTimeUtil.isIn(LocalDateTime.now(), | |
| 120 | LocalDateTime.of(nowDate, LocalTime.parse(startTime)), | |
| 121 | LocalDateTime.of(nowDate, LocalTime.parse(endTime))); | |
| 122 | } | |
| 123 | ||
| 124 | /** | |
| 125 | * 判断时间段是否重叠 | |
| 126 | * | |
| 127 | * @param startTime1 开始 time1 | |
| 128 | * @param endTime1 结束 time1 | |
| 129 | * @param startTime2 开始 time2 | |
| 130 | * @param endTime2 结束 time2 | |
| 131 | * @return 重叠：true 不重叠：false | |
| 132 | */ | |
| 133 | public static boolean isOverlap(LocalTime startTime1, LocalTime endTime1, LocalTime startTime2, LocalTime endTime2) { | |
| 134 | LocalDate nowDate = LocalDate.now(); | |
| 135 | return LocalDateTimeUtil.isOverlap(LocalDateTime.of(nowDate, startTime1), LocalDateTime.of(nowDate, endTime1), | |
| 136 | LocalDateTime.of(nowDate, startTime2), LocalDateTime.of(nowDate, endTime2)); | |
| 137 | } | |
| 138 | ||
| 139 | /** | |
| 140 | * 获取指定日期所在的月份的开始时间 | |
| 141 | * 例如：2023-09-30 00:00:00,000 | |
| 142 | * | |
| 143 | * @param date 日期 | |
| 144 | * @return 月份的开始时间 | |
| 145 | */ | |
| 146 | public static LocalDateTime beginOfMonth(LocalDateTime date) { | |
| 147 | return date.with(TemporalAdjusters.firstDayOfMonth()).with(LocalTime.MIN); | |
| 148 | } | |
| 149 | ||
| 150 | /** | |
| 151 | * 获取指定日期所在的月份的最后时间 | |
| 152 | * 例如：2023-09-30 23:59:59,999 | |
| 153 | * | |
| 154 | * @param date 日期 | |
| 155 | * @return 月份的结束时间 | |
| 156 | */ | |
| 157 | public static LocalDateTime endOfMonth(LocalDateTime date) { | |
| 158 | return date.with(TemporalAdjusters.lastDayOfMonth()).with(LocalTime.MAX); | |
| 159 | } | |
| 160 | ||
| 161 | /** | |
| 162 | * 获得指定日期所在季度 | |
| 163 | * | |
| 164 | * @param date 日期 | |
| 165 | * @return 所在季度 | |
| 166 | */ | |
| 167 | public static int getQuarterOfYear(LocalDateTime date) { | |
| 168 | return (date.getMonthValue() - 1) / 3 + 1; | |
| 169 | } | |
| 170 | ||
| 171 | /** | |
| 172 | * 获取指定日期到现在过了几天，如果指定日期在当前日期之后，获取结果为负 | |
| 173 | * | |
| 174 | * @param dateTime 日期 | |
| 175 | * @return 相差天数 | |
| 176 | */ | |
| 177 | public static Long between(LocalDateTime dateTime) { | |
| 178 | return LocalDateTimeUtil.between(dateTime, LocalDateTime.now(), ChronoUnit.DAYS); | |
| 179 | } | |
| 180 | ||
| 181 | /** | |
| 182 | * 获取今天的开始时间 | |
| 183 | * | |
| 184 | * @return 今天 | |
| 185 | */ | |
| 186 | public static LocalDateTime getToday() { | |
| 187 | return LocalDateTimeUtil.beginOfDay(LocalDateTime.now()); | |
| 188 | } | |
| 189 | ||
| 190 | /** | |
| 191 | * 获取昨天的开始时间 | |
| 192 | * | |
| 193 | * @return 昨天 | |
| 194 | */ | |
| 195 | public static LocalDateTime getYesterday() { | |
| 196 | return LocalDateTimeUtil.beginOfDay(LocalDateTime.now().minusDays(1)); | |
| 197 | } | |
| 198 | ||
| 199 | /** | |
| 200 | * 获取本月的开始时间 | |
| 201 | * | |
| 202 | * @return 本月 | |
| 203 | */ | |
| 204 | public static LocalDateTime getMonth() { | |
| 205 | return beginOfMonth(LocalDateTime.now()); | |
| 206 | } | |
| 207 | ||
| 208 | /** | |
| 209 | * 获取本年的开始时间 | |
| 210 | * | |
| 211 | * @return 本年 | |
| 212 | */ | |
| 213 | public static LocalDateTime getYear() { | |
| 214 | return LocalDateTime.now().with(TemporalAdjusters.firstDayOfYear()).with(LocalTime.MIN); | |
| 215 | } | |
| 216 | ||
| 217 | public static List<LocalDateTime[]> getDateRangeList(LocalDateTime startTime, | |
| 218 | LocalDateTime endTime, | |
| 219 | Integer interval) { | |
| 220 | // 1.1 找到枚举 | |
| 221 | DateIntervalEnum intervalEnum = DateIntervalEnum.valueOf(interval); | |
| 222 | Assert.notNull(intervalEnum, "interval({}} 找不到对应的枚举", interval); | |
| 223 | // 1.2 将时间对齐 | |
| 224 | startTime = LocalDateTimeUtil.beginOfDay(startTime); | |
| 225 | endTime = LocalDateTimeUtil.endOfDay(endTime); | |
| 226 | ||
| 227 | // 2. 循环，生成时间范围 | |
| 228 | List<LocalDateTime[]> timeRanges = new ArrayList<>(); | |
| 229 | switch (intervalEnum) { | |
| 230 | case DAY: | |
| 231 | while (startTime.isBefore(endTime)) { | |
| 232 | timeRanges.add(new LocalDateTime[]{startTime, startTime.plusDays(1).minusNanos(1)}); | |
| 233 | startTime = startTime.plusDays(1); | |
| 234 | } | |
| 235 | break; | |
| 236 | case WEEK: | |
| 237 | while (startTime.isBefore(endTime)) { | |
| 238 | LocalDateTime endOfWeek = startTime.with(DayOfWeek.SUNDAY).plusDays(1).minusNanos(1); | |
| 239 | timeRanges.add(new LocalDateTime[]{startTime, endOfWeek}); | |
| 240 | startTime = endOfWeek.plusNanos(1); | |
| 241 | } | |
| 242 | break; | |
| 243 | case MONTH: | |
| 244 | while (startTime.isBefore(endTime)) { | |
| 245 | LocalDateTime endOfMonth = startTime.with(TemporalAdjusters.lastDayOfMonth()).plusDays(1).minusNanos(1); | |
| 246 | timeRanges.add(new LocalDateTime[]{startTime, endOfMonth}); | |
| 247 | startTime = endOfMonth.plusNanos(1); | |
| 248 | } | |
| 249 | break; | |
| 250 | case QUARTER: | |
| 251 | while (startTime.isBefore(endTime)) { | |
| 252 | int quarterOfYear = getQuarterOfYear(startTime); | |
| 253 | LocalDateTime quarterEnd = quarterOfYear == 4 | |
| 254 | ? startTime.with(TemporalAdjusters.lastDayOfYear()).plusDays(1).minusNanos(1) | |
| 255 | : startTime.withMonth(quarterOfYear * 3 + 1).withDayOfMonth(1).minusNanos(1); | |
| 256 | timeRanges.add(new LocalDateTime[]{startTime, quarterEnd}); | |
| 257 | startTime = quarterEnd.plusNanos(1); | |
| 258 | } | |
| 259 | break; | |
| 260 | case YEAR: | |
| 261 | while (startTime.isBefore(endTime)) { | |
| 262 | LocalDateTime endOfYear = startTime.with(TemporalAdjusters.lastDayOfYear()).plusDays(1).minusNanos(1); | |
| 263 | timeRanges.add(new LocalDateTime[]{startTime, endOfYear}); | |
| 264 | startTime = endOfYear.plusNanos(1); | |
| 265 | } | |
| 266 | break; | |
| 267 | default: | |
| 268 | throw new IllegalArgumentException("Invalid interval: " + interval); | |
| 269 | } | |
| 270 | // 3. 兜底，最后一个时间，需要保持在 endTime 之前 | |
| 271 | LocalDateTime[] lastTimeRange = CollUtil.getLast(timeRanges); | |
| 272 | if (lastTimeRange != null) { | |
| 273 | lastTimeRange[1] = endTime; | |
| 274 | } | |
| 275 | return timeRanges; | |
| 276 | } | |
| 277 | ||
| 278 | /** | |
| 279 | * 格式化时间范围 | |
| 280 | * | |
| 281 | * @param startTime 开始时间 | |
| 282 | * @param endTime 结束时间 | |
| 283 | * @param interval 时间间隔 | |
| 284 | * @return 时间范围 | |
| 285 | */ | |
| 286 | public static String formatDateRange(LocalDateTime startTime, LocalDateTime endTime, Integer interval) { | |
| 287 | // 1. 找到枚举 | |
| 288 | DateIntervalEnum intervalEnum = DateIntervalEnum.valueOf(interval); | |
| 289 | Assert.notNull(intervalEnum, "interval({}} 找不到对应的枚举", interval); | |
| 290 | ||
| 291 | // 2. 循环，生成时间范围 | |
| 292 | switch (intervalEnum) { | |
| 293 | case DAY: | |
| 294 | return LocalDateTimeUtil.format(startTime, DatePattern.NORM_DATE_PATTERN); | |
| 295 | case WEEK: | |
| 296 | return LocalDateTimeUtil.format(startTime, DatePattern.NORM_DATE_PATTERN) | |
| 297 | + StrUtil.format("(第 {} 周)", LocalDateTimeUtil.weekOfYear(startTime)); | |
| 298 | case MONTH: | |
| 299 | return LocalDateTimeUtil.format(startTime, DatePattern.NORM_MONTH_PATTERN); | |
| 300 | case QUARTER: | |
| 301 | return StrUtil.format("{}-Q{}", startTime.getYear(), getQuarterOfYear(startTime)); | |
| 302 | case YEAR: | |
| 303 | return LocalDateTimeUtil.format(startTime, DatePattern.NORM_YEAR_PATTERN); | |
| 304 | default: | |
| 305 | throw new IllegalArgumentException("Invalid interval: " + interval); | |
| 306 | } | |
| 307 | } | |
| 308 | ||
| 309 | } | |
