Java LocalDate類 · HowToDoInJava 中文系列教程

# Java `LocalDate`類 > 原文： [https://howtodoinjava.com/java/date-time/java-time-localdate-class/](https://howtodoinjava.com/java/date-time/java-time-localdate-class/) [Java 8 中引入](https://howtodoinjava.com/java8/date-and-time-api-changes-in-java-8-lambda/)的`java.time.LocalDate`類，**表示沒有時區和時間的本地日期**，例如`2019-03-27`。它具有從一天中時刻開始的時間部分，即分鐘和秒被視為零。我們可以**使用`LocalDate`實例**來表示一天中沒有一天中特定時間的日期，例如生日，假期或員工休假。 `java.util.Date`和`java.time.LocalDate`之間的主要區別是`LocalDate`實例是[**不可變的**](https://howtodoinjava.com/java/basics/how-to-make-a-java-class-immutable/)和[**線程安全**](https://howtodoinjava.com/java/multi-threading/what-is-thread-safety/)。 ## 1\. 類聲明 ```java public final class LocalDate extends Object implements Temporal, TemporalAdjuster, ChronoLocalDate, Serializable { //class body } ``` ## 2\. 如何創建`LocalDate` 通常，我們將在兩種情況下創建本地日期實例，即獲取當前日期或為指定日期創建本地日期。 #### 2.1 獲取當前的本地日期使用以下方法獲取當前的本地日期。 ```java LocalDate today = LocalDate.now(); //1 - Recommended LocalDate today = LocalDate.ofInstant(Instant.now(), ZoneId.systemDefault()); // ``` #### 2.2 創建指定的本地日期要創建具有特定日期，月份和年份的本地日期，請使用以下方法。 ```java LocalDate dateInstance = LocalDate.of(2019, 3, 27); LocalDate dateInstance = LocalDate.parse("2019-03-27"); ``` ## 3\. 如何將字符串解析為`LocalDate` `LocalDate`類具有兩個重載的`parse()`方法，用于*將字符串日期轉換為本地日期*實例。 ```java parse(CharSequence text) //1 parse(CharSequence text, DateTimeFormatter formatter) //2 ``` * 如果字符串包含[`ISO_LOCAL_DATE`](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#ISO_LOCAL_DATE)模式中的日期，即`yyyy-MM-dd`，請使用第一種方法。這是 Java 中本地日期的**默認模式**。 * 對于其他任何日期模式，我們都需要使用第二種方法傳遞日期字符串以及表示該日期字符串的格式化器。 ```java //1 - default date pattern String date = "2019-03-23"; LocalDate localDate = LocalDate.parse(date); //2 - specific date pattern DateTimeFormatter formatter = DateTimeFormatter.ofPattern("d-MMM-yyyy"); String date = "23-Mar-2019"; LocalDate localDate = LocalDate.parse(date, formatter); ``` ## 4\. 如何將`LocalDate`格式化為字符串使用`LocalDate.format(DateTimeFormatter)`方法將本地日期格式化為所需的字符串表示形式。 ```java DateTimeFormatter formatter = DateTimeFormatter.ofPattern("d-MMM-yyyy"); LocalDate today = LocalDate.now(); String dateString = today.format(formatter); //23-Mar-2019 ``` ## 5\. 如何修改本地日期 `LocalDate`提供以下方法，這些方法可用于獲取相對于可用本地日期對象的新本地日期實例。 * `plusDays()` * `plusWeeks()` * `plusMonths()` * `plusYears()` * `minusDays()` * `minusWeeks()` * `minusMonths()` * `minusYears()` ```java LocalDate today = LocalDate.now(); //Same date 3 years later LocalDate localDate1 = today.plusYears(3); //local date before 3 months LocalDate localDate2 = today.minusMonths(3); ``` ## 6\. Java `LocalDate`示例通過一些示例，讓我們更好地了解`LocalDate`類。 * [將字符串解析為 Java 中的`LocalDate`](https://howtodoinjava.com/java/date-time/localdate-parse-string/) * [在 Java 中將`LocalDate`格式設置為字符串](https://howtodoinjava.com/java/date-time/localdate-format-example/) * [將 Java 中的`LocalDate`轉換為`java.util.Date`](https://howtodoinjava.com/java/date-time/localdate-to-date/) * [在 Java 中將日期轉換為`LocalDate`](https://howtodoinjava.com/java/date-time/localdate-to-date/) * [將 Java 中的`LocalDate`轉換為`java.sql.Date`](https://howtodoinjava.com/java/date-time/localdate-to-sql-date/) * [在 Java 中將`LocalDate`轉換為`ZonedDateTime`](https://howtodoinjava.com/java/date-time/localdate-zoneddatetime-conversion/) * [在 Java 中將`LocalDate`轉換為`LocalDateTime`](https://howtodoinjava.com/java/date-time/localdate-localdatetime-conversions/) 學習愉快！參考： [`LocalDate` Java 文檔](https://docs.oracle.com/javase/8/docs/api/java/time/LocalDate.html)