Java Period 类
Period 类是 Java 8 引入的一个日期时间 API 的一部分，位于 java.time 包中。
Period 类主要用于表示两个日期之间的时间间隔，以年、月、日为单位。与 Duration 类（表示基于时间的间隔，如小时、分钟、秒）不同，Period 专注于日期层面的差异。
核心特性
1. 不可变性
Period 类是不可变的（immutable），这意味着一旦创建了一个 Period 对象，它的值就不能被修改。任何对 Period 的操作（如加减）都会返回一个新的 Period 实例。
2. 基于日期的计算
Period 专门用于处理年、月、日的计算，适合处理生日、合同期限等场景。
3. 与 LocalDate 的配合
Period 通常与 LocalDate 类一起使用，用于计算两个日期之间的差异或在日期上添加/减去一段时间。
常用方法
创建 Period 对象
1. 使用 of() 方法
实例
Period period = Period.of(1, 2, 3); // 1 年 2 个月 3 天
2. 使用 between() 方法计算两个日期的间隔
实例
LocalDate startDate = LocalDate.of(2020, 1, 1);
LocalDate endDate = LocalDate.of(2021, 3, 4);
Period period = Period.between(startDate, endDate);
LocalDate endDate = LocalDate.of(2021, 3, 4);
Period period = Period.between(startDate, endDate);
3. 使用 parse() 方法从字符串创建
实例
Period period = Period.parse("P1Y2M3D"); // ISO-8601 格式
获取 Period 的各个部分
实例
int years = period.getYears(); // 获取年数
int months = period.getMonths(); // 获取月数
int days = period.getDays(); // 获取天数
int months = period.getMonths(); // 获取月数
int days = period.getDays(); // 获取天数
运算操作
1. 加减操作
实例
Period added = period.plusYears(1).plusMonths(2);
Period subtracted = period.minusDays(5);
Period subtracted = period.minusDays(5);
2. 判断是否为负
实例
boolean isNegative = period.isNegative();
3. 标准化 Period
实例
Period normalized = period.normalized(); // 将月数超过 12 的部分转换为年
实际应用示例
计算两个日期之间的间隔
实例
LocalDate birthDate = LocalDate.of(1990, 5, 15);
LocalDate currentDate = LocalDate.now();
Period age = Period.between(birthDate, currentDate);
System.out.printf("年龄: %d 年 %d 个月 %d 天",
age.getYears(), age.getMonths(), age.getDays());
LocalDate currentDate = LocalDate.now();
Period age = Period.between(birthDate, currentDate);
System.out.printf("年龄: %d 年 %d 个月 %d 天",
age.getYears(), age.getMonths(), age.getDays());
在日期上添加 Period
实例
LocalDate today = LocalDate.now();
Period twoMonths = Period.ofMonths(2);
LocalDate futureDate = today.plus(twoMonths);
Period twoMonths = Period.ofMonths(2);
LocalDate futureDate = today.plus(twoMonths);
检查时间段是否为空
实例
Period zeroPeriod = Period.of(0, 0, 0);
if (zeroPeriod.isZero()) {
System.out.println("这是一个零时间段");
}
if (zeroPeriod.isZero()) {
System.out.println("这是一个零时间段");
}
综合实例
实例
import java.time.Period;
import java.time.LocalDate;
public class PeriodDemo {
public static void main(String[] args) {
// 创建 Period 对象的几种方式
// 1. 使用 of() 方法
Period period1 = Period.of(1, 2, 15); // 1年2个月15天
System.out.println("Period 1: " + period1);
// 2. 使用 between() 方法计算两个日期之间的时段
LocalDate startDate = LocalDate.of(2020, 1, 1);
LocalDate endDate = LocalDate.of(2023, 5, 15);
Period period2 = Period.between(startDate, endDate);
System.out.println("Period between dates: " + period2);
// 3. 使用 parse() 方法从字符串创建
Period period3 = Period.parse("P1Y2M15D"); // ISO-8601格式
System.out.println("Parsed Period: " + period3);
}
}
import java.time.LocalDate;
public class PeriodDemo {
public static void main(String[] args) {
// 创建 Period 对象的几种方式
// 1. 使用 of() 方法
Period period1 = Period.of(1, 2, 15); // 1年2个月15天
System.out.println("Period 1: " + period1);
// 2. 使用 between() 方法计算两个日期之间的时段
LocalDate startDate = LocalDate.of(2020, 1, 1);
LocalDate endDate = LocalDate.of(2023, 5, 15);
Period period2 = Period.between(startDate, endDate);
System.out.println("Period between dates: " + period2);
// 3. 使用 parse() 方法从字符串创建
Period period3 = Period.parse("P1Y2M15D"); // ISO-8601格式
System.out.println("Parsed Period: " + period3);
}
}
输出结果为：
Period 1: P1Y2M15D Period between dates: P3Y4M14D Parsed Period: P1Y2M15D
注意事项
- 精度问题：
Period只计算年、月、日的差异，不考虑时间（小时、分钟等）的差异。 - 负值处理：如果结束日期早于开始日期，
Period.between()会返回负值。 - 月份天数差异：
Period的计算会考虑不同月份的天数差异（如 2 月有 28 或 29 天）。 - ISO-8601 格式：使用
parse()方法时，字符串必须遵循PnYnMnD格式（如 "P1Y2M3D"）。
总结
Period 类是 Java 日期时间 API 中处理基于日期的间隔的强大工具。通过它，开发者可以方便地进行年、月、日级别的日期计算，特别适合处理需要精确到日期的业务场景。掌握 Period 类的使用，能够让你的日期处理代码更加简洁和可读。
点我分享笔记