1. 项目缘起为什么我们需要一个日期工具类做后端开发尤其是用Java Spring Boot做业务系统处理日期时间简直是家常便饭。订单要按日、按月统计会员要计算到期日活动要设置开始和结束时间。每次遇到“获取本月第一天”、“计算上个月最后一天”或者“判断某个日期是星期几”这种需求你是不是也和我一样第一反应是去网上搜一下或者翻出自己以前项目里写的工具类复制粘贴一段代码过来我以前就是这么干的。直到有一次在一个用户活跃度统计的模块里我需要计算“当前季度的第一天”和“当前财年的最后一天”。我翻遍了手头的工具类发现只有一些零散的LocalDate.now().with(TemporalAdjusters.firstDayOfMonth())但更复杂的逻辑就得现场拼凑。更头疼的是不同业务线对“月初”的定义还不一样财务要求是自然月的1号0点而运营报表可能需要考虑到时区取的是北京时间当天的0点。代码里散落着各种Calendar、LocalDateTime、ZonedDateTime的转换和计算不仅重复而且稍有不慎就会因为时区或闰月等问题产生Bug。那次之后我下定决心要封装一个属于自己的、功能全面且鲁棒的日期时间工具类。它不仅要覆盖“年初第一天”、“月份最后一天”这些基础需求还要能优雅地处理“前天、明天、后天”这种相对日期以及“下个月第一天”、“上个月最后一天”这种跨月计算。今天我就把这个在多个Spring Boot生产项目中打磨过的工具类DateUtils分享出来并详细拆解其中的每一个核心方法的设计思路、实现细节以及我踩过的那些坑。2. 基石之选为什么是java.time而非Date或Calendar在动手写工具类之前第一个要做的关键决策就是基于哪个日期时间APIJava 8之前我们主要用java.util.Date和java.util.Calendar但这哥俩的槽点实在太多了。Date类设计得很糟糕它的大部分方法如getYear,getMonth在Java 1.1就被标记为Deprecated了而且它内部只存储一个自1970年1月1日 UTC 以来的毫秒数不包含时区信息但它的toString()方法却默认使用JVM的默认时区进行输出极易造成混淆。Calendar类试图解决一些问题但它本身是可变mutable的这在多线程环境下是个噩梦。它的API也非常反人类月份是从0开始计数的一月是0而星期几的常量定义也令人费解。所以我的选择毫无悬念Java 8引入的java.time包。这是JSR 310规范的实现由《Effective Java》的作者和Joda-Time库的作者共同设计旨在彻底解决旧API的所有问题。核心优势对比特性java.util.Date/Calendarjava.time(如LocalDate,ZonedDateTime)优势解读清晰性概念模糊Date包含日期时间时区但又不明确。类职责单一LocalDate(日期)、LocalTime(时间)、LocalDateTime(日期时间)、ZonedDateTime(带时区的日期时间)。从类名就能知道它是什么避免了误用。不可变性Calendar是可变的线程不安全。所有核心类都是不可变的immutable。天生线程安全可以放心地在多线程环境和作为方法参数传递。流畅APIAPI设计笨拙需要大量set、get操作。提供了大量流畅的plus,minus,with,at等方法链式调用。代码写起来更简洁更符合现代编程习惯。时区处理时区支持弱容易出错。专门提供了ZoneId,ZonedDateTime,OffsetDateTime等类时区处理强大而清晰。为全球化应用提供了坚实的基础。时间调节器需要自己写复杂逻辑计算“下个月第一天”。内置了TemporalAdjusters类提供了大量常用的调节器。像“本月最后一天”这种操作一行代码就能搞定。因此我们的DateUtils将完全构建在java.timeAPI之上。这不仅是技术选型更是为了代码的长期可维护性和开发体验。3. 核心工具类DateUtils设计与实现详解下面我将分模块展示这个工具类的核心代码并解释每一部分的设计考量。这个类被设计为final并且有一个私有构造器防止被实例化或继承因为它只提供静态工具方法。import java.time.*; import java.time.format.DateTimeFormatter; import java.time.temporal.TemporalAdjusters; /** * 基于 java.time 的日期时间工具类 * 提供常见的日期计算与格式化功能 */ public final class DateUtils { private DateUtils() { throw new UnsupportedOperationException(这是一个工具类禁止实例化); } // 定义常用的日期时间格式器避免重复创建 public static final DateTimeFormatter DATE_FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd); public static final DateTimeFormatter DATETIME_FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); public static final DateTimeFormatter TIME_FORMATTER DateTimeFormatter.ofPattern(HH:mm:ss); }3.1 获取特定时间点年初、月末与相对日期这是工具类最核心的部分对应标题中的大部分需求。我将其分为三类基于自然周期的边界如月初、基于相对日期的计算如前天、以及基于月份偏移的计算如下个月第一天。第一类自然周期边界这类需求的关键在于使用TemporalAdjusters这个神器。/** * 获取指定日期所在年份的第一天 * param date 指定日期如果为null则使用当前日期 * return 年初第一天LocalDate */ public static LocalDate getFirstDayOfYear(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.firstDayOfYear()); } /** * 获取指定日期所在月份的第一天 * param date 指定日期如果为null则使用当前日期 * return 月份第一天LocalDate */ public static LocalDate getFirstDayOfMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期所在月份的最后一天 * param date 指定日期如果为null则使用当前日期 * return 月份最后一天LocalDate */ public static LocalDate getLastDayOfMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.lastDayOfMonth()); } /** * 获取指定日期所在年份的最后一天 * param date 指定日期如果为null则使用当前日期 * return 年份最后一天LocalDate */ public static LocalDate getLastDayOfYear(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.lastDayOfYear()); }实操心得1关于TemporalAdjusters的威力TemporalAdjusters是java.time的精华之一。with(TemporalAdjuster)方法会返回一个调整后的新对象原对象不变体现了不可变性。除了上面用的还有firstInMonth(DayOfWeek.MONDAY)获取当月第一个星期一、lastInMonth(DayOfWeek.FRIDAY)当月最后一个星期五等非常强大。在需要类似“获取本月第二个周三”这种复杂逻辑时可以优先查查它是否已经提供了。第二类相对日期计算这类计算非常简单直接使用plusDays和minusDays即可。但这里有一个设计细节我提供了两个重载方法一个接收LocalDate参数一个使用当前日期。这提高了工具的灵活性。/** * 获取指定日期的前一天 * param date 指定日期如果为null则使用当前日期 * return 前一天的日期LocalDate */ public static LocalDate getYesterday(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusDays(1); } /** * 获取指定日期的后一天 * param date 指定日期如果为null则使用当前日期 * return 后一天的日期LocalDate */ public static LocalDate getTomorrow(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.plusDays(1); } /** * 获取指定日期的后天 * param date 指定日期如果为null则使用当前日期 * return 后天的日期LocalDate */ public static LocalDate getDayAfterTomorrow(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.plusDays(2); } /** * 获取指定日期的前天 * param date 指定日期如果为null则使用当前日期 * return 前天的日期LocalDate */ public static LocalDate getDayBeforeYesterday(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusDays(2); }第三类跨月计算这是稍微复杂一点的部分因为涉及到月份的加减和边界处理。例如从1月31号加一个月java.time会智能地返回2月28日或29日而不是产生一个无效的2月31日。这比旧的Calendar.add(Calendar.MONTH, 1)要安全得多。/** * 获取指定日期下个月的第一天 * param date 指定日期如果为null则使用当前日期 * return 下个月第一天的日期LocalDate */ public static LocalDate getFirstDayOfNextMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // 先跳到下个月再取第一天 return targetDate.plusMonths(1).with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期下个月的最后一天 * param date 指定日期如果为null则使用当前日期 * return 下个月最后一天的日期LocalDate */ public static LocalDate getLastDayOfNextMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // 先跳到下个月再取最后一天 return targetDate.plusMonths(1).with(TemporalAdjusters.lastDayOfMonth()); } /** * 获取指定日期上个月的第一天 * param date 指定日期如果为null则使用当前日期 * return 上个月第一天的日期LocalDate */ public static LocalDate getFirstDayOfPreviousMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusMonths(1).with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期上个月的最后一天 * param date 指定日期如果为null则使用当前日期 * return 上个月最后一天的日期LocalDate */ public static LocalDate getLastDayOfPreviousMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusMonths(1).with(TemporalAdjusters.lastDayOfMonth()); }踩坑实录1月份加减的“智能”与“陷阱”plusMonths和minusMonths是“智能”的。例如LocalDate.of(2023-01-31).plusMonths(1)的结果是2023-02-28。这通常是我们想要的业务逻辑避免无效日期。但是如果你业务上严格要求“1月31号的下个月同一天”不存在时应该抛出异常那这个“智能”处理反而成了问题。在这种情况下你需要使用date.plus(1, ChronoUnit.MONTHS)吗不它行为一样。真正的解决方案是如果你的业务日期逻辑非常严格可能需要在计算后额外校验date.getDayOfMonth() result.getDayOfMonth()是否成立。3.2 格式化、解析与常用判断一个完整的工具类当然不能只有计算。格式化和解析是日期处理中最常见的操作之一而一些简单的判断方法能极大简化业务代码。/** * 将LocalDate格式化为字符串yyyy-MM-dd * param date 日期 * return 格式化后的字符串如果date为null则返回null */ public static String formatDate(LocalDate date) { return date null ? null : date.format(DATE_FORMATTER); } /** * 将LocalDateTime格式化为字符串yyyy-MM-dd HH:mm:ss * param dateTime 日期时间 * return 格式化后的字符串如果dateTime为null则返回null */ public static String formatDateTime(LocalDateTime dateTime) { return dateTime null ? null : dateTime.format(DATETIME_FORMATTER); } /** * 将字符串解析为LocalDateyyyy-MM-dd * param dateStr 日期字符串 * return 解析后的LocalDate * throws DateTimeParseException 如果字符串格式不匹配 */ public static LocalDate parseDate(String dateStr) { return LocalDate.parse(dateStr, DATE_FORMATTER); } /** * 将字符串解析为LocalDateTimeyyyy-MM-dd HH:mm:ss * param dateTimeStr 日期时间字符串 * return 解析后的LocalDateTime * throws DateTimeParseException 如果字符串格式不匹配 */ public static LocalDateTime parseDateTime(String dateTimeStr) { return LocalDateTime.parse(dateTimeStr, DATETIME_FORMATTER); } /** * 判断两个日期是否在同一天 * param date1 日期1 * param date2 日期2 * return 是否在同一天 */ public static boolean isSameDay(LocalDate date1, LocalDate date2) { if (date1 null || date2 null) { return false; } return date1.isEqual(date2); } /** * 判断指定日期是否是今天 * param date 指定日期 * return 是否是今天 */ public static boolean isToday(LocalDate date) { return date ! null date.isEqual(LocalDate.now()); } /** * 判断指定日期是否在给定的开始和结束日期之间包含边界 * param date 要判断的日期 * param start 开始日期包含 * param end 结束日期包含 * return 是否在区间内 */ public static boolean isBetweenInclusive(LocalDate date, LocalDate start, LocalDate end) { if (date null || start null || end null) { return false; } return !date.isBefore(start) !date.isAfter(end); }实操心得2关于DateTimeFormatter的线程安全与性能旧版的SimpleDateFormat是线程不安全的必须每次创建或使用ThreadLocal。而java.time的DateTimeFormatter是线程安全的。这就是为什么我可以在类中将其定义为static final常量。这不仅能避免线程安全问题还能提升性能因为不需要反复创建和解析模式字符串。对于项目中的常用模式强烈建议这样定义。3.3 处理时区与时间戳从数据库到前端展示现代应用往往是分布式的服务器、数据库、用户可能位于不同时区。正确处理时区是避免“时间幽灵Bug”的关键。我们的工具类需要提供与数据库通常存储UTC时间戳、前端通常传递时间戳或ISO格式字符串交互的能力。/** * 将LocalDateTime转换为指定时区的毫秒时间戳 * param dateTime 本地日期时间通常认为是系统默认时区 * param zoneId 目标时区ID如Asia/Shanghai * return 毫秒时间戳 */ public static long toTimestamp(LocalDateTime dateTime, String zoneId) { if (dateTime null) { return 0L; } ZonedDateTime zonedDateTime dateTime.atZone(ZoneId.systemDefault()) .withZoneSameInstant(ZoneId.of(zoneId)); return zonedDateTime.toInstant().toEpochMilli(); } /** * 将毫秒时间戳转换为指定时区的LocalDateTime * param timestamp 毫秒时间戳 * param zoneId 目标时区ID如UTC * return 指定时区的LocalDateTime */ public static LocalDateTime fromTimestamp(long timestamp, String zoneId) { Instant instant Instant.ofEpochMilli(timestamp); return LocalDateTime.ofInstant(instant, ZoneId.of(zoneId)); } /** * 获取当前时间的UTC格式字符串ISO 8601 * return 如 2023-10-27T08:30:00Z */ public static String getCurrentUtcIsoString() { return Instant.now().toString(); } /** * 将UTC格式字符串转换为系统默认时区的LocalDateTime * param utcIsoString UTC ISO字符串 * return 系统默认时区的LocalDateTime */ public static LocalDateTime parseUtcToSystemDefault(String utcIsoString) { Instant instant Instant.parse(utcIsoString); return LocalDateTime.ofInstant(instant, ZoneId.systemDefault()); }踩坑实录2时区处理的“三明治”模型我推荐在系统中采用“三明治”模型处理时区存储层数据库统一使用UTC时间戳TIMESTAMP类型或BIGINT存储毫秒数。这是黄金标准。业务逻辑层Java后端在内存中使用LocalDateTime如果不关心时区或ZonedDateTime如果关心进行计算。从数据库取出时将UTC时间戳转换为Instant再根据业务需要转为特定时区。展示层前端/API向前端传递时间时可以传递UTC时间戳由前端根据用户本地时区渲染或者传递带时区信息的ISO字符串如2023-10-27T16:30:0008:00。绝对要避免在代码中硬编码“8”这样的时区偏移而是使用ZoneId.of(Asia/Shanghai)。因为夏令时DST等因素会让固定偏移出错。4. 在Spring Boot项目中的集成与实战应用有了工具类我们来看看如何在Spring Boot项目中优雅地使用它并解决一些常见的业务场景。4.1 如何引入与配置首先将DateUtils类放在项目的工具包下例如com.yourproject.common.utils。由于它只依赖Java 8标准库无需额外Maven依赖。但是在与数据库交互时我们经常用到MyBatis或JPA。这里需要特别注意java.time类型的映射。对于MyBatis-Plus用户MyBatis-Plus从3.x版本开始就内置了对java.time的支持你几乎不需要做任何配置。确保你的字段类型是LocalDate/LocalDateTimeMP会自动处理与数据库DATE/DATETIME/TIMESTAMP类型的转换。对于Spring Data JPA (Hibernate) 用户同样现代版本的Hibernate也完美支持java.time。你只需要在实体类中正常使用这些类型即可。import javax.persistence.*; import java.time.LocalDate; import java.time.LocalDateTime; Entity Table(name user_order) public class Order { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; private String orderNo; // 直接使用 LocalDate 和 LocalDateTime private LocalDate createDate; // 对应数据库 DATE 类型 private LocalDateTime payTime; // 对应数据库 DATETIME/TIMESTAMP 类型 // ... getters and setters }4.2 典型业务场景实战场景一生成月度统计报表的查询时间范围假设我们需要查询当前月份的所有订单数据。Service public class OrderStatisticsService { Autowired private OrderMapper orderMapper; // MyBatis Mapper public ListOrder getCurrentMonthOrders() { LocalDate today LocalDate.now(); LocalDate firstDayOfMonth DateUtils.getFirstDayOfMonth(today); LocalDate lastDayOfMonth DateUtils.getLastDayOfMonth(today); // 注意数据库查询通常需要包含时间边界。 // 对于create_date是DATE类型可以直接用 BETWEEN。 // 如果create_time是DATETIME需要将LocalDate转换为那一天的开始和结束时刻。 LocalDateTime startOfMonth firstDayOfMonth.atStartOfDay(); // 当月第一天 00:00:00 LocalDateTime endOfMonth lastDayOfMonth.atTime(23, 59, 59); // 当月最后一天 23:59:59 return orderMapper.selectBetweenCreateTime(startOfMonth, endOfMonth); } // 或者查询上个月的订单 public ListOrder getPreviousMonthOrders() { LocalDate today LocalDate.now(); LocalDate firstDayOfPrevMonth DateUtils.getFirstDayOfPreviousMonth(today); LocalDate lastDayOfPrevMonth DateUtils.getLastDayOfPreviousMonth(today); // ... 后续逻辑类似 } }场景二处理用户会员有效期用户购买了一个30天的会员需要计算到期日。Service public class MemberService { public void activateMember(Long userId, int durationDays) { LocalDate today LocalDate.now(); LocalDate expireDate today.plusDays(durationDays); // 业务逻辑如果会员存在且未过期则在原到期日上续期 Member member memberRepository.findByUserId(userId); if (member ! null member.getExpireDate() ! null) { // 使用 isAfter 判断原到期日是否在今天之后 if (member.getExpireDate().isAfter(today) || member.getExpireDate().isEqual(today)) { // 未过期在原日期上续期 expireDate member.getExpireDate().plusDays(durationDays); } } // 更新或创建会员记录 // ... save to database } /** * 判断用户会员是否在有效期内 */ public boolean isMemberActive(Long userId) { Member member memberRepository.findByUserId(userId); if (member null || member.getExpireDate() null) { return false; } // 使用工具类方法判断到期日是否不早于今天 return !member.getExpireDate().isBefore(LocalDate.now()); } }场景三定时任务中的日期计算一个每天凌晨运行的定时任务需要处理“昨天”的数据。Component public class DailyDataProcessTask { private static final Logger logger LoggerFactory.getLogger(DailyDataProcessTask.class); /** * 每天凌晨1点执行 */ Scheduled(cron 0 0 1 * * ?) public void processYesterdayData() { // 关键获取“昨天”的日期。使用工具类意图清晰。 LocalDate yesterday DateUtils.getYesterday(null); // null 表示使用当前日期 logger.info(开始处理日期为 {} 的数据, DateUtils.formatDate(yesterday)); // 1. 计算时间范围 LocalDateTime startOfYesterday yesterday.atStartOfDay(); LocalDateTime endOfYesterday yesterday.atTime(23, 59, 59); // 2. 从数据库查询昨天的数据 ListTransaction transactions transactionRepository.findByCreateTimeBetween(startOfYesterday, endOfYesterday); // 3. 处理业务逻辑... processTransactions(transactions, yesterday); logger.info(日期为 {} 的数据处理完成, DateUtils.formatDate(yesterday)); } private void processTransactions(ListTransaction transactions, LocalDate targetDate) { // ... 具体的业务处理 } }实操心得3Scheduled定时任务与服务器时区Spring Boot的Scheduledcron表达式默认使用服务器所在时区。如果你的应用部署在UTC时区的服务器上而业务时间是北京时间那么cron “0 0 1 * * ?”会在UTC时间凌晨1点即北京时间早上9点触发。这很可能不是你想要的。解决方案在application.yml中明确设置Spring的时区。spring: task: scheduling: # 设置调度器使用的时区例如 Asia/Shanghai zone: Asia/Shanghai这样cron表达式就会基于你设置的时区来解析。这是部署时很容易忽略的一个点。5. 进阶话题处理复杂周期与性能考量5.1 实现更复杂的周期计算我们的基础工具类已经很强大了但业务需求总是千变万化。比如产品经理突然说要支持“获取本财季第一天”或者“获取当前自然周周一”。我们可以轻松地扩展DateUtils。/** * 获取指定日期所在财季的第一天假设财年从4月1日开始 * param date 指定日期 * return 财季第一天 */ public static LocalDate getFirstDayOfFiscalQuarter(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; int month targetDate.getMonthValue(); int quarterStartMonth ((month - 1) / 3) * 3 1; // 计算财季起始月份1,4,7,10 // 调整财年偏移如果财年从4月开始需要处理跨年 int fiscalYear targetDate.getYear(); if (quarterStartMonth 4) { // 如果计算出的季度起始月在1月但财年从4月开始则属于上一财年 fiscalYear targetDate.minusYears(1).getYear(); } // 注意这里简化了实际财季计算可能更复杂需要根据具体财年定义调整 return LocalDate.of(fiscalYear, quarterStartMonth, 1); } /** * 获取指定日期所在周的星期一ISO标准周一为一周开始 * param date 指定日期 * return 当周星期一 */ public static LocalDate getMondayOfWeek(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // TemporalAdjusters.previousOrSame 可以获取上一个或同一天的指定星期几 return targetDate.with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY)); } /** * 获取指定日期所在周的星期日ISO标准周日为一周结束 * param date 指定日期 * return 当周星期日 */ public static LocalDate getSundayOfWeek(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY)); }5.2 性能优化与最佳实践对象复用正如之前提到的将DateTimeFormatter定义为static final常量是重要的性能优化。对于高频调用的方法也要注意避免在循环内创建不必要的临时对象。方法重载与默认值我们的工具类方法大多提供了接收LocalDate参数和默认为当前日期的版本。这提供了灵活性。但在性能敏感的循环中如果已知参数不为空调用带参数的方法可以避免一次LocalDate.now()的调用虽然其开销很小。考虑Joda-Time吗对于尚未升级到Java 8的老项目Joda-Time是一个优秀的备选。但既然有官方的java.time新项目就没有理由再引入Joda-Time了。如果你的工具类需要兼容老项目可以考虑写一个基于Joda-Time的版本但务必做好清晰的注释和隔离。测试测试测试日期时间逻辑的边界条件非常多闰年、闰月、月底、时区切换、夏令时。为你的DateUtils编写全面的单元测试至关重要。特别是那些涉及月份加减和月末计算的方法。SpringBootTest class DateUtilsTest { Test void testGetLastDayOfMonth() { // 测试平年二月 LocalDate date20230201 LocalDate.of(2023, 2, 1); assertEquals(LocalDate.of(2023, 2, 28), DateUtils.getLastDayOfMonth(date20230201)); // 测试闰年二月 LocalDate date20240201 LocalDate.of(2024, 2, 1); assertEquals(LocalDate.of(2024, 2, 29), DateUtils.getLastDayOfMonth(date20240201)); // 测试大月 LocalDate date20230115 LocalDate.of(2023, 1, 15); assertEquals(LocalDate.of(2023, 1, 31), DateUtils.getLastDayOfMonth(date20230115)); } Test void testGetFirstDayOfNextMonth_FromMonthEnd() { // 测试从1月31号获取下个月第一天 LocalDate jan31 LocalDate.of(2023, 1, 31); assertEquals(LocalDate.of(2023, 2, 1), DateUtils.getFirstDayOfNextMonth(jan31)); } }6. 总结与个人工具箱的维护回顾一下我们从一个常见的开发痛点出发一步步构建了一个基于现代java.timeAPI的、功能全面的日期时间工具类。它涵盖了从“获取昨天日期”到“计算财季第一天”的多种场景并考虑了时区、格式化、性能等实际问题。这个DateUtils类已经在我参与的几个Spring Boot项目中成为了基础设施的一部分。它的价值不在于代码有多复杂而在于统一了团队处理日期时间的范式消除了散落在各处的、可能不安全的Calendar代码让业务逻辑更加清晰可读。最后我想分享一点关于维护个人或团队工具库的心得不要追求大而全。这个工具类应该随着项目需求“生长”。当你在业务代码中第二次写下类似的日期计算逻辑时就应该考虑是否值得将它抽象到DateUtils中。同时为每个方法写好清晰的JavaDoc注释和对应的单元测试它的价值会随着时间不断放大。希望这个经过实战检验的工具类和其中包含的思路能帮你和你的团队更优雅地处理Java中的日期时间问题把精力更多地集中在核心业务逻辑上。
1. 项目缘起为什么我们需要一个日期工具类做后端开发尤其是用Java Spring Boot做业务系统处理日期时间简直是家常便饭。订单要按日、按月统计会员要计算到期日活动要设置开始和结束时间。每次遇到“获取本月第一天”、“计算上个月最后一天”或者“判断某个日期是星期几”这种需求你是不是也和我一样第一反应是去网上搜一下或者翻出自己以前项目里写的工具类复制粘贴一段代码过来我以前就是这么干的。直到有一次在一个用户活跃度统计的模块里我需要计算“当前季度的第一天”和“当前财年的最后一天”。我翻遍了手头的工具类发现只有一些零散的LocalDate.now().with(TemporalAdjusters.firstDayOfMonth())但更复杂的逻辑就得现场拼凑。更头疼的是不同业务线对“月初”的定义还不一样财务要求是自然月的1号0点而运营报表可能需要考虑到时区取的是北京时间当天的0点。代码里散落着各种Calendar、LocalDateTime、ZonedDateTime的转换和计算不仅重复而且稍有不慎就会因为时区或闰月等问题产生Bug。那次之后我下定决心要封装一个属于自己的、功能全面且鲁棒的日期时间工具类。它不仅要覆盖“年初第一天”、“月份最后一天”这些基础需求还要能优雅地处理“前天、明天、后天”这种相对日期以及“下个月第一天”、“上个月最后一天”这种跨月计算。今天我就把这个在多个Spring Boot生产项目中打磨过的工具类DateUtils分享出来并详细拆解其中的每一个核心方法的设计思路、实现细节以及我踩过的那些坑。2. 基石之选为什么是java.time而非Date或Calendar在动手写工具类之前第一个要做的关键决策就是基于哪个日期时间APIJava 8之前我们主要用java.util.Date和java.util.Calendar但这哥俩的槽点实在太多了。Date类设计得很糟糕它的大部分方法如getYear,getMonth在Java 1.1就被标记为Deprecated了而且它内部只存储一个自1970年1月1日 UTC 以来的毫秒数不包含时区信息但它的toString()方法却默认使用JVM的默认时区进行输出极易造成混淆。Calendar类试图解决一些问题但它本身是可变mutable的这在多线程环境下是个噩梦。它的API也非常反人类月份是从0开始计数的一月是0而星期几的常量定义也令人费解。所以我的选择毫无悬念Java 8引入的java.time包。这是JSR 310规范的实现由《Effective Java》的作者和Joda-Time库的作者共同设计旨在彻底解决旧API的所有问题。核心优势对比特性java.util.Date/Calendarjava.time(如LocalDate,ZonedDateTime)优势解读清晰性概念模糊Date包含日期时间时区但又不明确。类职责单一LocalDate(日期)、LocalTime(时间)、LocalDateTime(日期时间)、ZonedDateTime(带时区的日期时间)。从类名就能知道它是什么避免了误用。不可变性Calendar是可变的线程不安全。所有核心类都是不可变的immutable。天生线程安全可以放心地在多线程环境和作为方法参数传递。流畅APIAPI设计笨拙需要大量set、get操作。提供了大量流畅的plus,minus,with,at等方法链式调用。代码写起来更简洁更符合现代编程习惯。时区处理时区支持弱容易出错。专门提供了ZoneId,ZonedDateTime,OffsetDateTime等类时区处理强大而清晰。为全球化应用提供了坚实的基础。时间调节器需要自己写复杂逻辑计算“下个月第一天”。内置了TemporalAdjusters类提供了大量常用的调节器。像“本月最后一天”这种操作一行代码就能搞定。因此我们的DateUtils将完全构建在java.timeAPI之上。这不仅是技术选型更是为了代码的长期可维护性和开发体验。3. 核心工具类DateUtils设计与实现详解下面我将分模块展示这个工具类的核心代码并解释每一部分的设计考量。这个类被设计为final并且有一个私有构造器防止被实例化或继承因为它只提供静态工具方法。import java.time.*; import java.time.format.DateTimeFormatter; import java.time.temporal.TemporalAdjusters; /** * 基于 java.time 的日期时间工具类 * 提供常见的日期计算与格式化功能 */ public final class DateUtils { private DateUtils() { throw new UnsupportedOperationException(这是一个工具类禁止实例化); } // 定义常用的日期时间格式器避免重复创建 public static final DateTimeFormatter DATE_FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd); public static final DateTimeFormatter DATETIME_FORMATTER DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss); public static final DateTimeFormatter TIME_FORMATTER DateTimeFormatter.ofPattern(HH:mm:ss); }3.1 获取特定时间点年初、月末与相对日期这是工具类最核心的部分对应标题中的大部分需求。我将其分为三类基于自然周期的边界如月初、基于相对日期的计算如前天、以及基于月份偏移的计算如下个月第一天。第一类自然周期边界这类需求的关键在于使用TemporalAdjusters这个神器。/** * 获取指定日期所在年份的第一天 * param date 指定日期如果为null则使用当前日期 * return 年初第一天LocalDate */ public static LocalDate getFirstDayOfYear(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.firstDayOfYear()); } /** * 获取指定日期所在月份的第一天 * param date 指定日期如果为null则使用当前日期 * return 月份第一天LocalDate */ public static LocalDate getFirstDayOfMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期所在月份的最后一天 * param date 指定日期如果为null则使用当前日期 * return 月份最后一天LocalDate */ public static LocalDate getLastDayOfMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.lastDayOfMonth()); } /** * 获取指定日期所在年份的最后一天 * param date 指定日期如果为null则使用当前日期 * return 年份最后一天LocalDate */ public static LocalDate getLastDayOfYear(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.lastDayOfYear()); }实操心得1关于TemporalAdjusters的威力TemporalAdjusters是java.time的精华之一。with(TemporalAdjuster)方法会返回一个调整后的新对象原对象不变体现了不可变性。除了上面用的还有firstInMonth(DayOfWeek.MONDAY)获取当月第一个星期一、lastInMonth(DayOfWeek.FRIDAY)当月最后一个星期五等非常强大。在需要类似“获取本月第二个周三”这种复杂逻辑时可以优先查查它是否已经提供了。第二类相对日期计算这类计算非常简单直接使用plusDays和minusDays即可。但这里有一个设计细节我提供了两个重载方法一个接收LocalDate参数一个使用当前日期。这提高了工具的灵活性。/** * 获取指定日期的前一天 * param date 指定日期如果为null则使用当前日期 * return 前一天的日期LocalDate */ public static LocalDate getYesterday(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusDays(1); } /** * 获取指定日期的后一天 * param date 指定日期如果为null则使用当前日期 * return 后一天的日期LocalDate */ public static LocalDate getTomorrow(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.plusDays(1); } /** * 获取指定日期的后天 * param date 指定日期如果为null则使用当前日期 * return 后天的日期LocalDate */ public static LocalDate getDayAfterTomorrow(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.plusDays(2); } /** * 获取指定日期的前天 * param date 指定日期如果为null则使用当前日期 * return 前天的日期LocalDate */ public static LocalDate getDayBeforeYesterday(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusDays(2); }第三类跨月计算这是稍微复杂一点的部分因为涉及到月份的加减和边界处理。例如从1月31号加一个月java.time会智能地返回2月28日或29日而不是产生一个无效的2月31日。这比旧的Calendar.add(Calendar.MONTH, 1)要安全得多。/** * 获取指定日期下个月的第一天 * param date 指定日期如果为null则使用当前日期 * return 下个月第一天的日期LocalDate */ public static LocalDate getFirstDayOfNextMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // 先跳到下个月再取第一天 return targetDate.plusMonths(1).with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期下个月的最后一天 * param date 指定日期如果为null则使用当前日期 * return 下个月最后一天的日期LocalDate */ public static LocalDate getLastDayOfNextMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // 先跳到下个月再取最后一天 return targetDate.plusMonths(1).with(TemporalAdjusters.lastDayOfMonth()); } /** * 获取指定日期上个月的第一天 * param date 指定日期如果为null则使用当前日期 * return 上个月第一天的日期LocalDate */ public static LocalDate getFirstDayOfPreviousMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusMonths(1).with(TemporalAdjusters.firstDayOfMonth()); } /** * 获取指定日期上个月的最后一天 * param date 指定日期如果为null则使用当前日期 * return 上个月最后一天的日期LocalDate */ public static LocalDate getLastDayOfPreviousMonth(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.minusMonths(1).with(TemporalAdjusters.lastDayOfMonth()); }踩坑实录1月份加减的“智能”与“陷阱”plusMonths和minusMonths是“智能”的。例如LocalDate.of(2023-01-31).plusMonths(1)的结果是2023-02-28。这通常是我们想要的业务逻辑避免无效日期。但是如果你业务上严格要求“1月31号的下个月同一天”不存在时应该抛出异常那这个“智能”处理反而成了问题。在这种情况下你需要使用date.plus(1, ChronoUnit.MONTHS)吗不它行为一样。真正的解决方案是如果你的业务日期逻辑非常严格可能需要在计算后额外校验date.getDayOfMonth() result.getDayOfMonth()是否成立。3.2 格式化、解析与常用判断一个完整的工具类当然不能只有计算。格式化和解析是日期处理中最常见的操作之一而一些简单的判断方法能极大简化业务代码。/** * 将LocalDate格式化为字符串yyyy-MM-dd * param date 日期 * return 格式化后的字符串如果date为null则返回null */ public static String formatDate(LocalDate date) { return date null ? null : date.format(DATE_FORMATTER); } /** * 将LocalDateTime格式化为字符串yyyy-MM-dd HH:mm:ss * param dateTime 日期时间 * return 格式化后的字符串如果dateTime为null则返回null */ public static String formatDateTime(LocalDateTime dateTime) { return dateTime null ? null : dateTime.format(DATETIME_FORMATTER); } /** * 将字符串解析为LocalDateyyyy-MM-dd * param dateStr 日期字符串 * return 解析后的LocalDate * throws DateTimeParseException 如果字符串格式不匹配 */ public static LocalDate parseDate(String dateStr) { return LocalDate.parse(dateStr, DATE_FORMATTER); } /** * 将字符串解析为LocalDateTimeyyyy-MM-dd HH:mm:ss * param dateTimeStr 日期时间字符串 * return 解析后的LocalDateTime * throws DateTimeParseException 如果字符串格式不匹配 */ public static LocalDateTime parseDateTime(String dateTimeStr) { return LocalDateTime.parse(dateTimeStr, DATETIME_FORMATTER); } /** * 判断两个日期是否在同一天 * param date1 日期1 * param date2 日期2 * return 是否在同一天 */ public static boolean isSameDay(LocalDate date1, LocalDate date2) { if (date1 null || date2 null) { return false; } return date1.isEqual(date2); } /** * 判断指定日期是否是今天 * param date 指定日期 * return 是否是今天 */ public static boolean isToday(LocalDate date) { return date ! null date.isEqual(LocalDate.now()); } /** * 判断指定日期是否在给定的开始和结束日期之间包含边界 * param date 要判断的日期 * param start 开始日期包含 * param end 结束日期包含 * return 是否在区间内 */ public static boolean isBetweenInclusive(LocalDate date, LocalDate start, LocalDate end) { if (date null || start null || end null) { return false; } return !date.isBefore(start) !date.isAfter(end); }实操心得2关于DateTimeFormatter的线程安全与性能旧版的SimpleDateFormat是线程不安全的必须每次创建或使用ThreadLocal。而java.time的DateTimeFormatter是线程安全的。这就是为什么我可以在类中将其定义为static final常量。这不仅能避免线程安全问题还能提升性能因为不需要反复创建和解析模式字符串。对于项目中的常用模式强烈建议这样定义。3.3 处理时区与时间戳从数据库到前端展示现代应用往往是分布式的服务器、数据库、用户可能位于不同时区。正确处理时区是避免“时间幽灵Bug”的关键。我们的工具类需要提供与数据库通常存储UTC时间戳、前端通常传递时间戳或ISO格式字符串交互的能力。/** * 将LocalDateTime转换为指定时区的毫秒时间戳 * param dateTime 本地日期时间通常认为是系统默认时区 * param zoneId 目标时区ID如Asia/Shanghai * return 毫秒时间戳 */ public static long toTimestamp(LocalDateTime dateTime, String zoneId) { if (dateTime null) { return 0L; } ZonedDateTime zonedDateTime dateTime.atZone(ZoneId.systemDefault()) .withZoneSameInstant(ZoneId.of(zoneId)); return zonedDateTime.toInstant().toEpochMilli(); } /** * 将毫秒时间戳转换为指定时区的LocalDateTime * param timestamp 毫秒时间戳 * param zoneId 目标时区ID如UTC * return 指定时区的LocalDateTime */ public static LocalDateTime fromTimestamp(long timestamp, String zoneId) { Instant instant Instant.ofEpochMilli(timestamp); return LocalDateTime.ofInstant(instant, ZoneId.of(zoneId)); } /** * 获取当前时间的UTC格式字符串ISO 8601 * return 如 2023-10-27T08:30:00Z */ public static String getCurrentUtcIsoString() { return Instant.now().toString(); } /** * 将UTC格式字符串转换为系统默认时区的LocalDateTime * param utcIsoString UTC ISO字符串 * return 系统默认时区的LocalDateTime */ public static LocalDateTime parseUtcToSystemDefault(String utcIsoString) { Instant instant Instant.parse(utcIsoString); return LocalDateTime.ofInstant(instant, ZoneId.systemDefault()); }踩坑实录2时区处理的“三明治”模型我推荐在系统中采用“三明治”模型处理时区存储层数据库统一使用UTC时间戳TIMESTAMP类型或BIGINT存储毫秒数。这是黄金标准。业务逻辑层Java后端在内存中使用LocalDateTime如果不关心时区或ZonedDateTime如果关心进行计算。从数据库取出时将UTC时间戳转换为Instant再根据业务需要转为特定时区。展示层前端/API向前端传递时间时可以传递UTC时间戳由前端根据用户本地时区渲染或者传递带时区信息的ISO字符串如2023-10-27T16:30:0008:00。绝对要避免在代码中硬编码“8”这样的时区偏移而是使用ZoneId.of(Asia/Shanghai)。因为夏令时DST等因素会让固定偏移出错。4. 在Spring Boot项目中的集成与实战应用有了工具类我们来看看如何在Spring Boot项目中优雅地使用它并解决一些常见的业务场景。4.1 如何引入与配置首先将DateUtils类放在项目的工具包下例如com.yourproject.common.utils。由于它只依赖Java 8标准库无需额外Maven依赖。但是在与数据库交互时我们经常用到MyBatis或JPA。这里需要特别注意java.time类型的映射。对于MyBatis-Plus用户MyBatis-Plus从3.x版本开始就内置了对java.time的支持你几乎不需要做任何配置。确保你的字段类型是LocalDate/LocalDateTimeMP会自动处理与数据库DATE/DATETIME/TIMESTAMP类型的转换。对于Spring Data JPA (Hibernate) 用户同样现代版本的Hibernate也完美支持java.time。你只需要在实体类中正常使用这些类型即可。import javax.persistence.*; import java.time.LocalDate; import java.time.LocalDateTime; Entity Table(name user_order) public class Order { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; private String orderNo; // 直接使用 LocalDate 和 LocalDateTime private LocalDate createDate; // 对应数据库 DATE 类型 private LocalDateTime payTime; // 对应数据库 DATETIME/TIMESTAMP 类型 // ... getters and setters }4.2 典型业务场景实战场景一生成月度统计报表的查询时间范围假设我们需要查询当前月份的所有订单数据。Service public class OrderStatisticsService { Autowired private OrderMapper orderMapper; // MyBatis Mapper public ListOrder getCurrentMonthOrders() { LocalDate today LocalDate.now(); LocalDate firstDayOfMonth DateUtils.getFirstDayOfMonth(today); LocalDate lastDayOfMonth DateUtils.getLastDayOfMonth(today); // 注意数据库查询通常需要包含时间边界。 // 对于create_date是DATE类型可以直接用 BETWEEN。 // 如果create_time是DATETIME需要将LocalDate转换为那一天的开始和结束时刻。 LocalDateTime startOfMonth firstDayOfMonth.atStartOfDay(); // 当月第一天 00:00:00 LocalDateTime endOfMonth lastDayOfMonth.atTime(23, 59, 59); // 当月最后一天 23:59:59 return orderMapper.selectBetweenCreateTime(startOfMonth, endOfMonth); } // 或者查询上个月的订单 public ListOrder getPreviousMonthOrders() { LocalDate today LocalDate.now(); LocalDate firstDayOfPrevMonth DateUtils.getFirstDayOfPreviousMonth(today); LocalDate lastDayOfPrevMonth DateUtils.getLastDayOfPreviousMonth(today); // ... 后续逻辑类似 } }场景二处理用户会员有效期用户购买了一个30天的会员需要计算到期日。Service public class MemberService { public void activateMember(Long userId, int durationDays) { LocalDate today LocalDate.now(); LocalDate expireDate today.plusDays(durationDays); // 业务逻辑如果会员存在且未过期则在原到期日上续期 Member member memberRepository.findByUserId(userId); if (member ! null member.getExpireDate() ! null) { // 使用 isAfter 判断原到期日是否在今天之后 if (member.getExpireDate().isAfter(today) || member.getExpireDate().isEqual(today)) { // 未过期在原日期上续期 expireDate member.getExpireDate().plusDays(durationDays); } } // 更新或创建会员记录 // ... save to database } /** * 判断用户会员是否在有效期内 */ public boolean isMemberActive(Long userId) { Member member memberRepository.findByUserId(userId); if (member null || member.getExpireDate() null) { return false; } // 使用工具类方法判断到期日是否不早于今天 return !member.getExpireDate().isBefore(LocalDate.now()); } }场景三定时任务中的日期计算一个每天凌晨运行的定时任务需要处理“昨天”的数据。Component public class DailyDataProcessTask { private static final Logger logger LoggerFactory.getLogger(DailyDataProcessTask.class); /** * 每天凌晨1点执行 */ Scheduled(cron 0 0 1 * * ?) public void processYesterdayData() { // 关键获取“昨天”的日期。使用工具类意图清晰。 LocalDate yesterday DateUtils.getYesterday(null); // null 表示使用当前日期 logger.info(开始处理日期为 {} 的数据, DateUtils.formatDate(yesterday)); // 1. 计算时间范围 LocalDateTime startOfYesterday yesterday.atStartOfDay(); LocalDateTime endOfYesterday yesterday.atTime(23, 59, 59); // 2. 从数据库查询昨天的数据 ListTransaction transactions transactionRepository.findByCreateTimeBetween(startOfYesterday, endOfYesterday); // 3. 处理业务逻辑... processTransactions(transactions, yesterday); logger.info(日期为 {} 的数据处理完成, DateUtils.formatDate(yesterday)); } private void processTransactions(ListTransaction transactions, LocalDate targetDate) { // ... 具体的业务处理 } }实操心得3Scheduled定时任务与服务器时区Spring Boot的Scheduledcron表达式默认使用服务器所在时区。如果你的应用部署在UTC时区的服务器上而业务时间是北京时间那么cron “0 0 1 * * ?”会在UTC时间凌晨1点即北京时间早上9点触发。这很可能不是你想要的。解决方案在application.yml中明确设置Spring的时区。spring: task: scheduling: # 设置调度器使用的时区例如 Asia/Shanghai zone: Asia/Shanghai这样cron表达式就会基于你设置的时区来解析。这是部署时很容易忽略的一个点。5. 进阶话题处理复杂周期与性能考量5.1 实现更复杂的周期计算我们的基础工具类已经很强大了但业务需求总是千变万化。比如产品经理突然说要支持“获取本财季第一天”或者“获取当前自然周周一”。我们可以轻松地扩展DateUtils。/** * 获取指定日期所在财季的第一天假设财年从4月1日开始 * param date 指定日期 * return 财季第一天 */ public static LocalDate getFirstDayOfFiscalQuarter(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; int month targetDate.getMonthValue(); int quarterStartMonth ((month - 1) / 3) * 3 1; // 计算财季起始月份1,4,7,10 // 调整财年偏移如果财年从4月开始需要处理跨年 int fiscalYear targetDate.getYear(); if (quarterStartMonth 4) { // 如果计算出的季度起始月在1月但财年从4月开始则属于上一财年 fiscalYear targetDate.minusYears(1).getYear(); } // 注意这里简化了实际财季计算可能更复杂需要根据具体财年定义调整 return LocalDate.of(fiscalYear, quarterStartMonth, 1); } /** * 获取指定日期所在周的星期一ISO标准周一为一周开始 * param date 指定日期 * return 当周星期一 */ public static LocalDate getMondayOfWeek(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; // TemporalAdjusters.previousOrSame 可以获取上一个或同一天的指定星期几 return targetDate.with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY)); } /** * 获取指定日期所在周的星期日ISO标准周日为一周结束 * param date 指定日期 * return 当周星期日 */ public static LocalDate getSundayOfWeek(LocalDate date) { LocalDate targetDate date null ? LocalDate.now() : date; return targetDate.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY)); }5.2 性能优化与最佳实践对象复用正如之前提到的将DateTimeFormatter定义为static final常量是重要的性能优化。对于高频调用的方法也要注意避免在循环内创建不必要的临时对象。方法重载与默认值我们的工具类方法大多提供了接收LocalDate参数和默认为当前日期的版本。这提供了灵活性。但在性能敏感的循环中如果已知参数不为空调用带参数的方法可以避免一次LocalDate.now()的调用虽然其开销很小。考虑Joda-Time吗对于尚未升级到Java 8的老项目Joda-Time是一个优秀的备选。但既然有官方的java.time新项目就没有理由再引入Joda-Time了。如果你的工具类需要兼容老项目可以考虑写一个基于Joda-Time的版本但务必做好清晰的注释和隔离。测试测试测试日期时间逻辑的边界条件非常多闰年、闰月、月底、时区切换、夏令时。为你的DateUtils编写全面的单元测试至关重要。特别是那些涉及月份加减和月末计算的方法。SpringBootTest class DateUtilsTest { Test void testGetLastDayOfMonth() { // 测试平年二月 LocalDate date20230201 LocalDate.of(2023, 2, 1); assertEquals(LocalDate.of(2023, 2, 28), DateUtils.getLastDayOfMonth(date20230201)); // 测试闰年二月 LocalDate date20240201 LocalDate.of(2024, 2, 1); assertEquals(LocalDate.of(2024, 2, 29), DateUtils.getLastDayOfMonth(date20240201)); // 测试大月 LocalDate date20230115 LocalDate.of(2023, 1, 15); assertEquals(LocalDate.of(2023, 1, 31), DateUtils.getLastDayOfMonth(date20230115)); } Test void testGetFirstDayOfNextMonth_FromMonthEnd() { // 测试从1月31号获取下个月第一天 LocalDate jan31 LocalDate.of(2023, 1, 31); assertEquals(LocalDate.of(2023, 2, 1), DateUtils.getFirstDayOfNextMonth(jan31)); } }6. 总结与个人工具箱的维护回顾一下我们从一个常见的开发痛点出发一步步构建了一个基于现代java.timeAPI的、功能全面的日期时间工具类。它涵盖了从“获取昨天日期”到“计算财季第一天”的多种场景并考虑了时区、格式化、性能等实际问题。这个DateUtils类已经在我参与的几个Spring Boot项目中成为了基础设施的一部分。它的价值不在于代码有多复杂而在于统一了团队处理日期时间的范式消除了散落在各处的、可能不安全的Calendar代码让业务逻辑更加清晰可读。最后我想分享一点关于维护个人或团队工具库的心得不要追求大而全。这个工具类应该随着项目需求“生长”。当你在业务代码中第二次写下类似的日期计算逻辑时就应该考虑是否值得将它抽象到DateUtils中。同时为每个方法写好清晰的JavaDoc注释和对应的单元测试它的价值会随着时间不断放大。希望这个经过实战检验的工具类和其中包含的思路能帮你和你的团队更优雅地处理Java中的日期时间问题把精力更多地集中在核心业务逻辑上。
