【JAVA】Date、LocalDate、LocalDateTime 详解，实践应用

一、Date、LocalDate 简介

在 Java 中，处理日期和时间的方式经历了演变。在 Java 8 之前，主要使用 java.util.Date 类来表示日期和时间，但它存在一些问题，如不可变性、线程安全性等。Java 8 引入了新的日期时间 API，位于 java.time 包中，提供了更加强大、易用和安全的日期时间处理方式。以下是对于不同类型的时间表达的详细解释：

1、 java.util.Date：

是 Java 中早期用于表示日期和时间的类。 表示一个特定的日期和时间，以自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数来表示。 不可变的，表示一个时间点，但是其设计存在一些问题，如线程不安全、设计上不够清晰等。

2、 java.time.LocalDateTime：

是 Java 8 中引入的日期时间类之一，位于 java.time 包中。 表示不带时区的日期和时间，即一个本地的日期时间，不受时区影响。使用 LocalDateTime.now() 来获取当前本地日期时间。 例如LocalDateTime.of(2022, Month.JANUARY, 1, 12, 0) 可以创建一个表示 2022 年 1 月 1 日中午 12 点的 LocalDateTime 对象。

3、 java.time.LocalDate：

也是 Java 8 中引入的日期时间类之一，位于 java.time 包中。 表示日期，即年、月、日，不包含时间信息。 使用 LocalDate.now() 来获取当前本地日期。 例如，LocalDate.of(2022, Month.JANUARY, 1) 可以创建一个表示 2022 年 1 月 1 日的 LocalDate 对象。

二、输出格式

当在项目中使用日期时间处理时，新的日期时间 API 提供了更加清晰和灵活的方式。让我们来比较一下使用旧的 java.util.Date 和新的 java.time.LocalDateTime 在项目中的用法和输出。

假设我们有一个需求：在系统中记录用户创建账户的时间，并输出到日志中。

1、使用 java.util.Date 的示例代码如下：

import java.util.Date;

public class AccountService {
    public void createUserAccount() {
        // 创建用户账户的业务逻辑
        Date creationDate = new Date();
        
        // 记录创建账户的时间到日志
        System.out.println("User account created on: " + creationDate);
    }
}

2、使用 java.time.LocalDateTime 的示例代码如下：

import java.time.LocalDateTime;

public class AccountService {
    public void createUserAccount() {
        // 创建用户账户的业务逻辑
        LocalDateTime creationDateTime = LocalDateTime.now();
        
        // 记录创建账户的时间到日志
        System.out.println("User account created on: " + creationDateTime);
    }
}

现在我们来比较两者的输出：

假设我们在项目中的某个时间点创建了一个用户账户。

使用 java.util.Date 输出示例：

User account created on: Sun Mar 13 14:58:27 GMT 2024

使用 java.time.LocalDateTime 输出示例：

User account created on: 2024-03-13T14:58:27.327

可以看到，使用 java.time.LocalDateTime 输出的日期时间格式更加清晰和标准化，包含了年、月、日、时、分、秒和毫秒，并且不受系统时区的影响。而使用 java.util.Date 输出的日期时间格式虽然也能表达时间，但格式不如 LocalDateTime 那样标准化，并且需要考虑时区等因素。因此，使用新的日期时间 API 更加推荐，可以让代码更加清晰、易读和可维护。

三、区别

当处理日期时，使用 Date 和 LocalDate 这两种类型有着不同的优缺点。让我们来比较一下它们，并从几个方面讨论它们的使用：

1、表示的范围：

• Date 类型：Date 类型表示自 1970 年 1 月 1 日以来的毫秒数。它包含了日期和时间的信息。
• LocalDate 类型：LocalDate 类型只表示日期，不包含时间信息。它提供了更加简单和直接的日期表示方式。

2、线程安全性：

• Date 类型：Date 类型是可变的，因此不是线程安全的。在多线程环境中使用 Date 类型需要额外的同步措施来确保线程安全。
• LocalDate 类型：LocalDate 类型是不可变的，因此线程安全。多个线程可以同时访问和使用 LocalDate 实例而无需担心并发问题。

3、可读性和易用性：

• Date 类型：Date 类型的 API 相对复杂，而且在大多数情况下不提供直接的方法来处理日期。因此，它可能导致代码更加难以理解和维护。

• LocalDate 类型：LocalDate 类型提供了清晰、简洁和易用的 API，使得处理日期变得更加直观和方便。例如，可以使用 plusDays()、minusDays() 等方法来进行日期计算。用于对日期进行加减操作。这些方法允许你在不改变 LocalDate 实例本身的情况下，对日期进行简单的算术运算。

  • plusDays(long daysToAdd) 方法：
    这个方法接受一个长整型参数 daysToAdd，用于指定要添加的天数。它返回一个新的 LocalDate 实例，该实例表示在当前日期的基础上添加了指定的天数。
    示例：

    LocalDate currentDate = LocalDate.now(); 	
    // 在当前日期的基础上加7天
    LocalDate futureDate = currentDate.plusDays(7); 
    

  • minusDays(long daysToSubtract) 方法：
    这个方法接受一个长整型参数 daysToSubtract，用于指定要减去的天数。 它返回一个新的 LocalDate 实例，该实例表示在当前日期的基础上减去了指定的天数。
    示例：

    LocalDate currentDate = LocalDate.now(); 
    // 在当前日期的基础上减去7天
    LocalDate pastDate = currentDate.minusDays(7);  
    

  这些方法提供了简单、直观的方式来执行日期计算，而不需要考虑月份、年份和闰年等复杂的问题。这样，你可以更加轻松地对日期进行加减操作，而不必担心日期的正确性。

4、时区：

• Date 类型：Date 类型表示的日期和时间是基于 UTC 时间的，需要考虑时区问题时可能会复杂一些。
• LocalDate 类型：LocalDate 类型不包含时区信息，仅表示本地日期，因此对于涉及时区问题的应用场景可能不太适用。

综上所述，如果你只需要处理日期而不涉及时间和时区信息，并且希望代码更加清晰和易读，那么推荐使用 LocalDate 类型。如果你需要同时处理日期和时间，并且需要考虑时区等问题，那么可能需要使用 Date 类型或者 java.time.LocalDateTime 类型。但是，尽量避免直接使用 Date 类型，推荐使用新的 java.time 包中提供的日期时间 API。

四、项目中的使用

1、数据库中的数据是date类型，在实体类中对应什么类型？

如果数据库中的数据类型是 Date，那么在 Java 的实体类中对应的类型通常是 java.sql.Date 或者 java.time.LocalDate。这取决于你使用的是老的 JDBC API 还是新的 java.time 包。

（1）使用 java.sql.Date：

如果你在项目中使用的是老的 JDBC API，并且数据库中的数据类型是 date，那么你可以在实体类中使用 java.sql.Date 来表示日期。java.sql.Date 对象表示 SQL DATE 类型，只包含日期部分，不包含时间。
例如：

import java.sql.Date;

public class Entity {
    private Date dateColumn;

    // Getter and setter methods
}

（2）使用 java.time.LocalDate：

如果你在项目中使用的是新的 java.time 包，并且你希望在实体类中使用现代的日期时间 API，那么你可以使用 java.time.LocalDate 来表示日期。java.time.LocalDate 表示不带时间的日期，只包含年、月、日部分。
例如：

import java.time.LocalDate;

public class Entity {
    private LocalDate dateColumn;

    // Getter and setter methods
}

无论你选择使用 java.sql.Date 还是 java.time.LocalDate，都可以在实体类中正确地映射数据库中 date 类型的数据。不过，推荐使用新的 java.time 包中的日期时间 API，因为它更加现代化、易用和功能强大。

2、数据库中的数据是time类型，在实体类中对应什么类型？

如果数据库中的数据类型是 time，在 Java 的实体类中对应的类型通常是 java.sql.Time 或者 java.time.LocalTime。同样，这取决于你使用的是老的 JDBC API 还是新的 java.time 包。

（1）使用 java.sql.Time：

如果你在项目中使用的是老的 JDBC API，并且数据库中的数据类型是 time，那么你可以在实体类中使用 java.sql.Time 来表示时间。
java.sql.Time 对象表示 SQL TIME 类型，只包含时间部分，不包含日期。
例如：

import java.sql.Time;

public class Entity {
    private Time timeColumn;

    // Getter and setter methods
}

可以使用 System.currentTimeMillis() 方法来获取当前时间的毫秒数，然后将其转换为 Time 类型。例如：

import java.sql.Time;

public class Main {
    public static void main(String[] args) {
        Time currentTime = new Time(System.currentTimeMillis());
        System.out.println("当前时间：" + currentTime);
    }
}

这将输出类似于 当前时间：15:30:45 的格式，其中 15:30:45 是当前时间的时分秒。

(2)、使用 java.time.LocalTime：

如果你在项目中使用的是新的 java.time 包，并且你希望在实体类中使用现代的日期时间 API，那么你可以使用 java.time.LocalTime 来表示时间。
java.time.LocalTime 表示不带日期的时间，只包含时、分、秒和纳秒部分。
例如：

import java.time.LocalTime;

public class Entity {
    private LocalTime timeColumn;

    // Getter and setter methods
}

可以使用 LocalTime.now() 方法。例如：

import java.time.LocalTime;

public class Main {
    public static void main(String[] args) {
        LocalTime currentTime = LocalTime.now();
        System.out.println("当前时间：" + currentTime);
    }
}

这也将输出类似于 当前时间：15:30:45.123456789 的格式，其中 15:30:45.123456789 是当前时间的时分秒和纳秒。这个格式更加精确，包括了纳秒级别的精度。

无论你选择使用 java.sql.Time 还是 java.time.LocalTime，都可以在实体类中正确地映射数据库中 time 类型的数据。同样，推荐使用新的 java.time 包中的日期时间 API，因为它更加现代化、易用和功能强大。