在Java开发中，日期的加减操作是常见的需求，例如计算订单截止日期、员工试用期到期时间、统计周期数据等，Java提供了多种日期时间API来实现这些操作，从早期的Date和Calendar类，到Java 8引入的java.time包，功能不断丰富，使用也愈发便捷，本文将详细介绍不同API下日期加减的实现方法,并对比其优劣。
传统Date与Calendar类的日期加减
在Java 8之前，Date和Calendar是处理日期的主要工具。Date类表示特定的瞬间，但自身不提供日期加减方法，而Calendar类作为Date的替代，提供了更丰富的日期操作功能。
基于Calendar的日期加减
Calendar是一个抽象类，通过Calendar.getInstance()获取实例后，可以通过add()和roll()方法实现日期加减。
-
add()方法：直接在指定字段上增加或减少值，同时会向上级字段进位或借位。
add(Calendar.MONTH, 1)会将月份加1，如果当前是12月，则会自动进位到下一年1月。Calendar calendar = Calendar.getInstance(); calendar.add(Calendar.MONTH, 2); // 月份加2 calendar.add(Calendar.DAY_OF_MONTH, -5); // 日期减5 Date resultDate = calendar.getTime();
-
roll()方法：与
add()类似，但仅修改指定字段，不向上级字段进位。roll(Calendar.MONTH, 1)在12月加1时，结果仍为12月，年份不变。
缺点：Calendar类的设计存在诸多问题，例如月份从0开始计数（0代表1月），线程不安全，API设计不够直观，因此在实际开发中逐渐被java.time包取代。
Java 8时间API的日期加减（推荐）
Java 8引入的java.time包是全新的日期时间API，解决了旧API的线程安全问题，并提供了更简洁、易用的操作方式，核心类包括LocalDate（日期）、LocalDateTime（日期时间）、ZonedDateTime（带时区的日期时间）等。
LocalDate的日期加减
LocalDate表示不含时区的日期，通过plusXxx()和minusXxx()方法实现加减操作，支持天、周、月、年等单位。
-
加操作：
plusDays()、plusWeeks()、plusMonths()、plusYears()LocalDate date = LocalDate.now(); LocalDate plusDate = date.plusDays(10) // 加10天 .plusMonths(1) // 加1个月 .plusYears(2); // 加2年 -
减操作：
minusDays()、minusWeeks()、minusMonths()、minusYears()LocalDate minusDate = date.minusWeeks(2) // 减2周 .minusYears(1); // 减1年
LocalDateTime的日期时间加减
LocalDateTime是日期和时间的组合，加减方法与LocalDate类似，但增加了对小时、分钟、秒的支持。
LocalDateTime dateTime = LocalDateTime.now();
LocalDateTime result = dateTime.plusHours(3) // 加3小时
.minusMinutes(30) // 减30分钟
.plusSeconds(15); // 加15秒
Period和Duration：计算时间间隔
除了直接加减日期字段，java.time还提供了Period和Duration类用于处理时间间隔。
-
Period：用于日期间隔，支持年、月、日计算。
LocalDate start = LocalDate.of(2023, 1, 1); LocalDate end = LocalDate.of(2024, 1, 1); Period period = Period.between(start, end); // 计算间隔 System.out.println("相差年数：" + period.getYears()); // 输出1 -
Duration：用于时间间隔（秒、纳秒），适用于
LocalDateTime或Instant。LocalDateTime start = LocalDateTime.of(2023, 1, 1, 12, 0); LocalDateTime end = LocalDateTime.of(2023, 1, 1, 15, 30); Duration duration = Duration.between(start, end); System.out.println("相差分钟数：" + duration.toMinutes()); // 输出210
日期加减的注意事项
- 线程安全：
java.time包下的所有类都是不可变且线程安全的，而Calendar是线程不安全的，多线程环境下需要额外加锁。 - 时区处理：若涉及跨时区日期计算，应使用
ZonedDateTime或OffsetDateTime，避免因时区差异导致日期错误。 - 边界值处理：例如2月28日加1个月，结果可能是3月28日或3月31日（取决于具体实现），需根据业务需求选择处理逻辑，Java 8的
plusMonths()会直接取对应月份的“最后一天”作为结果（如1月31日加1个月为2月28日/29日）。
Java中日期加减操作经历了从Calendar到java.time的演进。Calendar虽然功能强大，但存在线程安全和API设计缺陷，不推荐在新项目中使用，Java 8的java.timeAPI凭借其不可变性、线程安全和简洁的API设计，成为当前日期时间处理的最佳选择，开发时应优先使用LocalDate、LocalDateTime及其plusXxx()/minusXxx()方法，结合Period和Duration处理复杂的时间间隔计算,确保代码的健壮性和可维护性。
