Java 8 日期时间 API

在 Java 8 之前，日期和时间的处理一直是 Java 开发者的一大痛点。传统的 java.util.Date 和 java.util.Calendar 类不仅设计不够直观，且线程不安全，易于出错。Java 8 引入了全新的日期时间 API，大大简化了日期时间的操作。本文将重点介绍 Java 8 的 LocalDate, LocalTime, 和 LocalDateTime 类。

1. LocalDate 类

LocalDate 类表示一个日期，默认格式为 yyyy-MM-dd，不包含时间信息。该类是不可变且线程安全的。

创建 LocalDate 实例

可以使用多种方式创建 LocalDate 实例：

import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        // 获取当前日期
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期: " + today);

        // 创建指定日期
        LocalDate specificDate = LocalDate.of(2020, 1, 1);
        System.out.println("指定日期: " + specificDate);

        // 解析字符串
        LocalDate parsedDate = LocalDate.parse("2023-07-15");
        System.out.println("解析日期: " + parsedDate);
    }
}

LocalDate 的常用操作

public class LocalDateOperations {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();

        // 获取年份、月份和日
        int year = today.getYear();
        int month = today.getMonthValue();
        int day = today.getDayOfMonth();
        System.out.printf("年: %d, 月: %d, 日: %d%n", year, month, day);

        // 加减操作
        LocalDate nextWeek = today.plusWeeks(1);
        System.out.println("一周后的日期: " + nextWeek);

        LocalDate previousMonth = today.minusMonths(1);
        System.out.println("一个月前的日期: " + previousMonth);

        // 判断是否闰年
        boolean isLeapYear = today.isLeapYear();
        System.out.println("今年是闰年吗？ " + isLeapYear);
    }
}

2. LocalTime 类

LocalTime 类表示一个时间，不包含日期信息。默认格式为 HH:mm:ss，同样是不可变且线程安全的。

创建 LocalTime 实例

import java.time.LocalTime;

public class LocalTimeExample {
    public static void main(String[] args) {
        // 获取当前时间
        LocalTime now = LocalTime.now();
        System.out.println("当前时间: " + now);

        // 创建指定时间
        LocalTime specificTime = LocalTime.of(15, 30, 45);
        System.out.println("指定时间: " + specificTime);

        // 解析字符串
        LocalTime parsedTime = LocalTime.parse("10:15:30");
        System.out.println("解析时间: " + parsedTime);
    }
}

LocalTime 的常用操作

public class LocalTimeOperations {
    public static void main(String[] args) {
        LocalTime now = LocalTime.now();

        // 获取小时、分钟和秒
        int hour = now.getHour();
        int minute = now.getMinute();
        int second = now.getSecond();
        System.out.printf("时: %d, 分: %d, 秒: %d%n", hour, minute, second);

        // 加减操作
        LocalTime nextHour = now.plusHours(1);
        System.out.println("一小时后的时间: " + nextHour);

        LocalTime previousMinute = now.minusMinutes(1);
        System.out.println("一分钟前的时间: " + previousMinute);

        // 判断时间是否在某个时间之前或之后
        LocalTime specificTime = LocalTime.of(12, 0);
        boolean isBefore = now.isBefore(specificTime);
        boolean isAfter = now.isAfter(specificTime);
        System.out.printf("现在时间在12:00之前吗？ %b, 之后吗？ %b%n", isBefore, isAfter);
    }
}

3. LocalDateTime 类

LocalDateTime 类表示一个日期时间，结合了 LocalDate 和 LocalTime 的功能，默认格式为 yyyy-MM-ddTHH:mm:ss。

创建 LocalDateTime 实例

import java.time.LocalDateTime;

public class LocalDateTimeExample {
    public static void main(String[] args) {
        // 获取当前日期时间
        LocalDateTime now = LocalDateTime.now();
        System.out.println("当前日期时间: " + now);

        // 创建指定日期时间
        LocalDateTime specificDateTime = LocalDateTime.of(2023, 7, 15, 10, 30, 45);
        System.out.println("指定日期时间: " + specificDateTime);

        // 解析字符串
        LocalDateTime parsedDateTime = LocalDateTime.parse("2023-07-15T10:30:45");
        System.out.println("解析日期时间: " + parsedDateTime);
    }
}

LocalDateTime 的常用操作

public class LocalDateTimeOperations {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();

        // 获取日期和时间的各个部分
        int year = now.getYear();
        int month = now.getMonthValue();
        int day = now.getDayOfMonth();
        int hour = now.getHour();
        int minute = now.getMinute();
        int second = now.getSecond();
        System.out.printf("年: %d, 月: %d, 日: %d, 时: %d, 分: %d, 秒: %d%n", year, month, day, hour, minute, second);

        // 加减操作
        LocalDateTime nextDay = now.plusDays(1);
        System.out.println("一天后的日期时间: " + nextDay);

        LocalDateTime previousHour = now.minusHours(1);
        System.out.println("一小时前的日期时间: " + previousHour);

        // 转换为 `LocalDate` 和 `LocalTime`
        LocalDate datePart = now.toLocalDate();
        LocalTime timePart = now.toLocalTime();
        System.out.println("日期部分: " + datePart);
        System.out.println("时间部分: " + timePart);
    }
}

4. 结合使用 LocalDate, LocalTime 和 LocalDateTime

LocalDate, LocalTime 和 LocalDateTime 可以相互转换和配合使用，进一步增强了日期时间处理的灵活性。

public class DateTimeConversion {
    public static void main(String[] args) {
        // 从 `LocalDate` 和 `LocalTime` 创建 `LocalDateTime`
        LocalDate date = LocalDate.of(2023, 7, 15);
        LocalTime time = LocalTime.of(10, 30, 45);
        LocalDateTime dateTime = LocalDateTime.of(date, time);
        System.out.println("从日期和时间创建的日期时间: " + dateTime);

        // 从 `LocalDateTime` 提取 `LocalDate` 和 `LocalTime`
        LocalDate extractedDate = dateTime.toLocalDate();
        LocalTime extractedTime = dateTime.toLocalTime();
        System.out.println("提取的日期: " + extractedDate);
        System.out.println("提取的时间: " + extractedTime);
    }
}

结论

Java 8 引入的新的日期时间 API 为日期时间处理提供了更清晰、更直观和更强大的工具。LocalDate, LocalTime 和 LocalDateTime 类不仅解决了传统日期时间处理中的诸多问题，还增强了代码的可读性和可维护性。希望本文对你理解和使用 Java 8 日期时间 API 有所帮助。