当前位置： 首页 > news >正文

springboot 工具类 日期时间列表工具类详解：高效处理日期范围的利器

news 2025/11/5 9:10:31

日期时间列表工具类详解：高效处理日期范围的利器

在日常开发中，我们经常需要处理各种日期时间相关的业务逻辑，比如生成日期范围、计算时间差、处理闰年等。今天给大家分享一个功能强大的日期时间工具类 DateListUtil，它封装了常见的日期操作，让日期处理变得简单高效。

工具类概述

DateListUtil 是一个专门用于处理日期时间列表的工具类，主要功能包括：

  • 生成日期范围内的每一天
  • 生成时间范围内的小时列表
  • 计算日期时间差
  • 处理日期时间的加减操作
  • 闰年判断和日期格式化

核心功能详解

1. 生成日期范围列表

/*** 获取两个日期之间的每一天* @param beginDate 开始日期 (格式: yyyy-MM-dd)* @param endDate 结束日期 (格式: yyyy-MM-dd)* @return 日期字符串列表*/
public static List<String> getEveryday(String beginDate, String endDate) {long days = countDay(beginDate, endDate);int[] ymd = splitYMD(beginDate);List<String> everyDays = new ArrayList();everyDays.add(beginDate);for(int i = 0; (long)i < days; ++i) {ymd = addOneDay(ymd[0], ymd[1], ymd[2]);everyDays.add(formatYear(ymd[0]) + "-" + formatMonthDay(ymd[1]) + "-" + formatMonthDay(ymd[2]));}return everyDays;
}

使用示例：

List<String> dateList = DateListUtil.getEveryday("2024-01-01", "2024-01-05");
// 返回: ["2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04", "2024-01-05"]

2. 生成小时列表

/*** 获取两个日期时间之间的小时列表* @param beginDate 开始时间 (格式: yyyy-MM-dd HH:mm)* @param endDate 结束时间 (格式: yyyy-MM-dd HH:mm)* @return 小时字符串列表*/
public static List<String> getEveryHour(String beginDate, String endDate) {long hours = countHour(beginDate, endDate);List<String> everyHours = new ArrayList();for(int i = 0; (long)i < hours + 1L; ++i) {DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");LocalDateTime now = LocalDateTime.parse(beginDate, formatter);LocalDateTime oneHourLater = now.plusHours((long)i);String date = oneHourLater.format(formatter);int[] ymd = splitYMDH(date);everyHours.add(formatMonthDay(ymd[3]));}return everyHours;
}

使用示例：

List<String> hourList = DateListUtil.getEveryHour("2024-01-01 08:00", "2024-01-01 12:00");
// 返回: ["08", "09", "10", "11", "12"]

3. 时间偏移计算

/*** 获取指定时间前后的小时时间* @param beginDate 基准时间* @param hour 小时数* @param fal true:加小时, false:减小时* @return 计算后的时间字符串*/
public static String getSpecialdHour(String beginDate, Integer hour, boolean fal) {DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");LocalDateTime now = LocalDateTime.parse(beginDate, formatter);String date;if (fal) {LocalDateTime oneHourLater = now.plusHours((long)hour);date = oneHourLater.format(formatter);} else {LocalDateTime oneHourLater = now.minus(Duration.ofHours((long)hour));date = oneHourLater.format(formatter);}return date;
}

使用示例：

// 加3小时
String laterTime = DateListUtil.getSpecialdHour("2024-01-01 10:00", 3, true);
// 返回: "2024-01-01 13:00"// 减2小时  
String earlierTime = DateListUtil.getSpecialdHour("2024-01-01 10:00", 2, false);
// 返回: "2024-01-01 08:00"

4. 时间差计算

// 计算天数差
public static long countDay(String begin, String end) {SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");long day = 0L;try {Date beginDate = format.parse(begin);Date endDate = format.parse(end);day = (endDate.getTime() - beginDate.getTime()) / 86400000L;} catch (ParseException var8) {var8.printStackTrace();}return day;
}// 计算小时差
public static long countHour(String begin, String end) {SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm");long hour = 0L;try {Date beginDate = format.parse(begin);Date endDate = format.parse(end);hour = (endDate.getTime() - beginDate.getTime()) / 3600000L;} catch (ParseException var8) {var8.printStackTrace();}return hour;
}

使用示例：

long days = DateListUtil.countDay("2024-01-01", "2024-01-10"); // 返回: 9
long hours = DateListUtil.countHour("2024-01-01 08:00", "2024-01-01 18:00"); // 返回: 10

技术亮点

1. 混合使用新旧日期API

工具类巧妙地将传统的 SimpleDateFormat 与现代的 LocalDateTime 结合使用：

// 传统API - 用于简单的时间差计算
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
Date beginDate = format.parse(begin);// 现代API - 用于复杂的时间操作
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
LocalDateTime now = LocalDateTime.parse(beginDate, formatter);

2. 精确的闰年处理

public static boolean isLeapYear(int year) {return year >= gregorianCutoverYear ? (year % 4 == 0 && (year % 100 != 0 || year % 400 == 0)) : (year % 4 == 0);
}// 闰年和平年的每月天数数组
private static final int[] DAYS_P_MONTH_LY = new int[]{31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};
private static final int[] DAYS_P_MONTH_CY = new int[]{31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};

3. 日期分量智能处理

// 拆分年月日
public static int[] splitYMD(String date) {date = date.replace("-", "").replace(" ", "");return new int[]{Integer.parseInt(date.substring(0, 4)),   // 年Integer.parseInt(date.substring(4, 6)),   // 月  Integer.parseInt(date.substring(6, 8))    // 日};
}// 格式化保证两位数
public static String formatMonthDay(int decimal) {DecimalFormat df = new DecimalFormat("00");return df.format((long)decimal);
}

实际应用场景

1. 报表系统

// 生成月度报表的日期范围
public List<Report> generateMonthlyReport(String month) {String startDate = month + "-01";String endDate = month + "-31"; // 实际应该计算当月最后一天List<String> dates = DateListUtil.getEveryday(startDate, endDate);List<Report> reports = new ArrayList<>();for (String date : dates) {Report report = generateDailyReport(date);reports.add(report);}return reports;
}

2. 数据统计

// 统计每小时的访问量
public Map<String, Integer> getHourlyVisitStats(String startTime, String endTime) {List<String> hours = DateListUtil.getEveryHour(startTime, endTime);Map<String, Integer> stats = new LinkedHashMap<>();for (String hour : hours) {int count = getVisitCountByHour(hour);stats.put(hour + ":00", count);}return stats;
}

3. 任务调度

// 计算任务执行时间
public void scheduleTask(String baseTime, int delayHours) {String executeTime = DateListUtil.getSpecialdHour(baseTime, delayHours, true);// 计算任务预计完成时间（假设任务需要2小时）String estimatedEndTime = DateListUtil.getSpecialdHour(executeTime, 2, true);scheduleTaskAt(executeTime, estimatedEndTime);
}

使用注意事项

  1. 日期格式要求

    • 日期格式必须为 yyyy-MM-dd
    • 日期时间格式必须为 yyyy-MM-dd HH:mm

  2. 异常处理

    • 方法内部捕获了 ParseException，但生产环境建议改进异常处理
    • 调用方应确保传入的日期格式正确

  3. 性能考虑

    • 对于大数据量的日期范围，建议分批处理
    • 频繁调用时注意字符串操作的性能开销

  4. 线程安全

    • SimpleDateFormat 不是线程安全的，需要注意使用场景

总结

DateListUtil 工具类为我们提供了一套完整的日期时间处理解决方案，具有以下优点：

  • 功能全面：覆盖了日常开发中大部分的日期时间处理需求
  • 使用简单：方法封装良好，调用方便
  • 算法准确：正确处理了闰年、月末等边界情况
  • 灵活性强：支持多种日期时间操作场景

无论是报表生成、数据分析还是任务调度，这个工具类都能大大提升开发效率。希望这个工具类能够对大家的项目开发有所帮助！

完整代码

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by FernFlower decompiler)
//package com.mnsn.framework.boot.utils;import java.text.DecimalFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.Duration;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;public class DateListUtil {private static transient int gregorianCutoverYear = 1582;private static final int[] DAYS_P_MONTH_LY = new int[]{31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};private static final int[] DAYS_P_MONTH_CY = new int[]{31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};public static final String SHORT_DATE_FORMAT = "yyyy-MM-dd";private static final int Y = 0;private static final int M = 1;private static final int D = 2;private static final int H = 3;public DateListUtil() {}public static List<String> getEveryday(String beginDate, String endDate) {long days = countDay(beginDate, endDate);int[] ymd = splitYMD(beginDate);List<String> everyDays = new ArrayList();everyDays.add(beginDate);for(int i = 0; (long)i < days; ++i) {ymd = addOneDay(ymd[0], ymd[1], ymd[2]);String var10001 = formatYear(ymd[0]);everyDays.add(var10001 + "-" + formatMonthDay(ymd[1]) + "-" + formatMonthDay(ymd[2]));}return everyDays;}public static List<String> getEveryHour(String beginDate, String endDate) {long hours = countHour(beginDate, endDate);List<String> everyHours = new ArrayList();for(int i = 0; (long)i < hours + 1L; ++i) {DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");LocalDateTime now = LocalDateTime.parse(beginDate, formatter);LocalDateTime oneHourLater = now.plusHours((long)i);String date = oneHourLater.format(formatter);int[] ymd = splitYMDH(date);everyHours.add(formatMonthDay(ymd[3]));}return everyHours;}public static String getSpecialdHour(String beginDate, Integer hour, boolean fal) {DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");LocalDateTime now = LocalDateTime.parse(beginDate, formatter);String date;LocalDateTime oneHourLater;if (fal) {oneHourLater = now.plusHours((long)hour);date = oneHourLater.format(formatter);} else {oneHourLater = now.minus(Duration.ofHours((long)hour));date = oneHourLater.format(formatter);}return date;}public static long countDay(String begin, String end) {SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");long day = 0L;try {Date beginDate = format.parse(begin);Date endDate = format.parse(end);day = (endDate.getTime() - beginDate.getTime()) / 86400000L;} catch (ParseException var8) {var8.printStackTrace();}return day;}public static long countHour(String begin, String end) {SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm");long hour = 0L;try {Date beginDate = format.parse(begin);Date endDate = format.parse(end);hour = (endDate.getTime() - beginDate.getTime()) / 3600000L;} catch (ParseException var8) {var8.printStackTrace();}return hour;}public static int[] splitYMD(String date) {date = date.replace("-", "").replace(" ", "");int[] ymd = new int[]{Integer.parseInt(date.substring(0, 4)), Integer.parseInt(date.substring(4, 6)), Integer.parseInt(date.substring(6, 8))};return ymd;}public static int[] splitYMDH(String date) {date = date.replace("-", "").replace(" ", "");int[] ymd = new int[]{Integer.parseInt(date.substring(0, 4)), Integer.parseInt(date.substring(4, 6)), Integer.parseInt(date.substring(6, 8)), Integer.parseInt(date.substring(8, 10))};return ymd;}private static int[] addOneDay(int year, int month, int day) {if (isLeapYear(year)) {++day;if (day > DAYS_P_MONTH_LY[month - 1]) {++month;if (month > 12) {++year;month = 1;}day = 1;}} else {++day;if (day > DAYS_P_MONTH_CY[month - 1]) {++month;if (month > 12) {++year;month = 1;}day = 1;}}int[] ymd = new int[]{year, month, day};return ymd;}public static boolean isLeapYear(int year) {return year >= gregorianCutoverYear ? year % 4 == 0 && (year % 100 != 0 || year % 400 == 0) : year % 4 == 0;}public static String formatYear(int decimal) {DecimalFormat df = new DecimalFormat("0000");return df.format((long)decimal);}public static String formatMonthDay(int decimal) {DecimalFormat df = new DecimalFormat("00");return df.format((long)decimal);}public static int convert0to24(int hour) {return hour == 0 ? 24 : hour;}
}
http://www.dtcms.com/a/569293.html

相关文章：

  • MYSQL第四次作业
  • 某游戏大厂分布式系统经典实战面试题解析
  • 某游戏大厂计算机网络面试问题深度解析(一)
  • C#基础：如何从现有类库复制一个新的类库，并且加入解决方案
  • C# 中 Entity Framework (EF) 和 EF Core 里的 `AsNoTracking` 方法
  • 基于视觉分析的加油站通话行为安全预警系统 构建加油安全新防线 通话行为模式识别 边缘计算通话动作监测设备
  • Traefik vs Spring Cloud：微服务架构的两种截然不同的技术路线
  • 郑州百度seo网站优广州网站开发外包哪家好
  • 高端网站建设推来客网络做seo推广公司
  • 数据挖掘6-AI总结
  • 网站首页域名如何设置访问快宿迁沭阳网站建设
  • 数据结构 —— 栈
  • 微信小程序开发案例 | 个人相册小程序（下）
  • 网站域名账号网址申请注册
  • 电商 API 数据交互最佳实践：JSON 格式优化、数据校验与异常处理
  • 重庆网站建设 沛宣织梦cms 官方网站
  • 零基础新手小白快速了解掌握服务集群与自动化运维（十七）ELK日志分析模块--Elasticsearch介绍与配置
  • 如何使用elasticdump进行elasticsearch数据还原
  • 【运维记录】Centos 7 基础命令缺失
  • 手写 RPC 框架
  • etcd 高可用分布式键值存储
  • 【ETCD】ETCD单节点二进制部署(TLS)
  • 小网站 收入请简述网站制作流程
  • 抗辐照MCU芯片在无人叉车领域的性能评估与选型建议
  • 什么是LLM？
  • Java/PHP源码解析：一站式上门维修服务系统的全栈实现
  • MPU6050 DMP 移植中 mpu_run_self_test () 自检失败的原因与解决方法
  • 系统端实现看门狗功能
  • 算法--二分查找（二）
  • 没有网站备案可以做诚信认证嘛商城网站大概多少钱