Java 8 的 java.time 包相較于舊的 date 和 Calendar api 提供了更強大、直觀且線程安全的日期時間處理方案。1. 核心類包括 localdate（僅日期）、localtime（僅時間）、localdatetime（無時區的日期時間）、instant（時間戳）、zoneddatetime（帶時區的日期時間）、duration（基于秒的時間差）和 period（基于年月日的時間差）。2. 這些類不可變，所有修改操作返回新實例，避免并發問題。3. 使用 datetimeformatter 實現線程安全的格式化與解析。4. 支持便捷的日期計算，如 plusdays、minusyears 等鏈式調用。5. 提供清晰的類型轉換路徑，支持與舊 api 的互操作。6. 相比之下，舊 api 存在可變性、不一致性和線程不安全等問題，應優先使用現代 api 以提升代碼健壯性和可維護性。
Java日期時間處理，從舊的java.util.Date和java.util.Calendar到現代的java.time包（JSR 310），經歷了顯著的演變。掌握后者是關鍵，它提供了更強大、更直觀、線程安全的解決方案，極大地簡化了日期時間的操作和計算，讓開發者能更優雅地處理時間維度上的各種復雜需求。
解決方案 說實話，每次看到代碼里還在大量用new Date()或者Calendar.getInstance()，我心里都會咯噔一下。這不僅僅是代碼風格的問題，更是一個潛在的雷區。Java 8引入的java.time包徹底改變了我們處理日期時間的方式。它基于ISO 8601標準，提供了一套全新的、不可變且線程安全的API。
核心思想是區分：
- LocalDate: 只有日期，沒有時間，也沒有時區信息。比如“2023年10月27日”。
- LocalTime: 只有時間，沒有日期，也沒有時區信息。比如“下午3點30分”。
- LocalDateTime: 日期和時間都有，但沒有時區信息。比如“2023年10月27日下午3點30分”。
- Instant: 時間線上的一個瞬時點，精確到納秒，通常用于記錄事件發生的時間戳。它不帶時區，通常是UTC時間。
- ZonedDateTime: 帶有完整時區信息的日期和時間。這是處理跨時區業務邏輯的關鍵。
- Duration: 用于表示兩個Instant之間的時間量，基于秒和納秒。
- Period: 用于表示兩個LocalDate之間的時間量，基于年、月、日。
這些類都是不可變的，這意味著一旦創建，它們的值就不能被改變。所有修改操作（比如plusDays()、minusHours()）都會返回一個新的實例，這極大地簡化了并發編程，避免了舊API中常見的線程安全問題。
立即學習“Java免費學習筆記（深入）”；
獲取當前日期和時間：
LocalDate today = LocalDate.now(); // 今天的日期 LocalTime now = LocalTime.now(); // 當前時間 LocalDateTime currentDateTime = LocalDateTime.now(); // 當前日期和時間 Instant currentInstant = Instant.now(); // 當前瞬時點（UTC） ZonedDateTime currentZonedDateTime = ZonedDateTime.now(); // 當前帶時區日期時間
創建特定日期和時間：
LocalDate specificDate = LocalDate.of(2023, 10, 27); LocalTime specificTime = LocalTime.of(15, 30, 0); LocalDateTime specificDateTime = LocalDateTime.of(2023, 10, 27, 15, 30);
日期時間計算：java.time提供了非常直觀的方法進行加減操作：
LocalDate nextWeek = today.plusWeeks(1); LocalDateTime nextMonthSameTime = currentDateTime.plusMonths(1); LocalDateTime twoHoursLater = currentDateTime.plusHours(2); LocalDate lastYear = today.minusYears(1);
格式化與解析： 使用DateTimeFormatter進行日期時間的格式化和解析，它也是線程安全的：
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); String formattedDateTime = currentDateTime.format(formatter); // "2023-10-27 15:30:00" (示例) String dateString = "2024-01-01 10:00:00"; LocalDateTime parsedDateTime = LocalDateTime.parse(dateString, formatter);
為什么我們應該放棄舊的Date和Calendar API？ 舊的java.util.Date和java.util.Calendar API，它們的設計確實存在一些先天不足，讓開發者在實際使用中踩了不少坑。我個人覺得，最讓人頭疼的就是它們的“可變性”。當你把一個Date對象傳遞給某個方法，那個方法如果修改了它，你原始的Date對象也就跟著變了，這在多線程環境下簡直是災難，調試起來特別痛苦，常常出現意想不到的副作用。
Date類的命名本身也容易引起誤解。它實際上代表的是一個時間點（精確到毫秒），而不是一個日期概念。比如，new Date()創建的是當前時間點，而不是“今天”這個日期。你想要獲取年、月、日，還得借助Calendar。
而Calendar呢？它的API設計過于冗長和復雜。比如，月份是從0開始的（0代表1月），這導致了無數的“差一”錯誤。還有，它同樣是可變的，也不是線程安全的。這意味著在并發場景下，你需要手動進行同步，這無疑增加了開發的復雜性和出錯的概率。
所以，放棄它們不是為了追新，而是為了規避這些歷史遺留問題，讓代碼更健壯、更易讀、更易維護。
java.time包的核心類如何簡化日期時間操作？java.time包的設計哲學就是“分而治之”和“不可變性”。它把日期、時間、日期時間、瞬時點、時區等概念都用獨立的、職責單一的類來表示，這讓代碼的意圖變得非常清晰。
- LocalDate: 想象一下，你只想知道今天是幾月幾號，不需要關心現在是幾點幾分幾秒，也不需要關心你在哪個時區。LocalDate就是為此而生。比如，記錄一個人的生日，或者一個節假日，LocalDate.of(1990, 5, 15)就足夠了。
- LocalTime: 類似地，如果你只想表示一個時間點，比如商店的開門時間“上午9點”，LocalTime.of(9, 0)就非常直觀。
- LocalDateTime: 當你需要同時表示日期和時間，但又不涉及跨時區轉換時，LocalDateTime是你的首選。比如，一個會議的開始時間，或者一個日志事件的發生時間。它不包含時區信息，所以如果你在倫敦和紐約同時用LocalDateTime.now()，得到的結果會是各自本地的日期時間。
- Instant: 這是一個非常底層的概念，它代表了時間線上的一個精確點，通常是自unix紀元（1970-01-01T00:00:00Z）以來的秒數和納秒數。它不帶任何時區概念，是處理時間戳、數據庫存儲或網絡傳輸時非常方便的統一表示。
- ZonedDateTime: 這是處理時區問題的終極武器。它包含了LocalDateTime的所有信息，再加上一個ZoneId（時區ID）。當你需要安排一個跨國會議，或者處理不同時區用戶提交的數據時，ZonedDateTime能確保時間轉換的準確性。比如，北京時間下午3點的會議，在紐約是凌晨3點，ZonedDateTime能幫你正確地進行這些轉換。
- Duration與Period: 這對搭檔用于計算時間差。Duration側重于時間量，比如“兩個小時”或“30秒”，它適用于Instant或LocalTime之間的計算。而Period則側重于日期量，比如“兩年三個月零五天”，它適用于LocalDate之間的計算。這種區分讓時間差的計算變得非常語義化。
這些類的操作方法都采用了鏈式調用，例如LocalDate.now().plusDays(1).minusMonths(2)，這讓代碼讀起來就像自然語言一樣流暢。
如何在不同日期時間類型之間進行轉換和格式化？ 在實際開發中，不同日期時間類型之間的轉換和字符串的格式化與解析是家常便飯。java.time提供了非常清晰的路徑。
類型轉換： 從舊的java.util.Date到新的java.time：
java.util.Date oldDate = new java.util.Date(); Instant instant = oldDate.toInstant(); // Date -> Instant LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, ZoneId.systemDefault()); // Instant -> LocalDateTime (帶上系統默認時區) ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(instant, ZoneId.of("America/New_York")); // Instant -> ZonedDateTime (指定時區)
從新的java.time到舊的java.util.Date：
LocalDateTime newDateTime = LocalDateTime.now(); // LocalDateTime -> Instant -> Date (需要一個時區來確定Instant) java.util.Date convertedDate = java.util.Date.from(newDateTime.atZone(ZoneId.systemDefault()).toInstant());
LocalDateTime與ZonedDateTime之間的轉換：
LocalDateTime ldt = LocalDateTime.now(); ZonedDateTime zdt = ldt.atZone(ZoneId.systemDefault()); // 給LocalDateTime加上系統默認時區 ZonedDateTime specificZdt = ZonedDateTime.now(ZoneId.of("Europe/London")); LocalDateTime convertedLdt = specificZdt.toLocalDateTime(); // ZonedDateTime -> LocalDateTime (丟失時區信息)
要注意的是，從ZonedDateTime轉換到LocalDateTime會丟失時區信息，因為LocalDateTime本身就不包含時區。
格式化與解析： 格式化這塊，說實話，一開始我總記不住那些字母代表什么，比如yyyy是年，MM是月，dd是日。但用多了就發現，它比以前的SimpleDateFormat好用太多了，至少不用擔心線程安全問題了。
DateTimeFormatter是核心，它提供了多種創建方式：
- 預定義常量： 針對常見格式，比如ISO_DATE、ISO_DATE_TIME。
LocalDateTime now = LocalDateTime.now(); String isoDate = now.format(DateTimeFormatter.ISO_LOCAL_DATE); // "2023-10-27" String isoDateTime = now.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME); // "2023-10-27T15:30:00"
- 自定義模式： 使用ofPattern()方法，你可以根據需求定義任意格式。
DateTimeFormatter customFormatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss"); String chineseFormat = now.format(customFormatter); // "2023年10月27日 15:30:00"這里需要注意大小寫：MM是月份，mm是分鐘；HH是24小時制，hh是12小時制。
解析字符串到日期時間對象：
String dateStr = "2023-10-27 15:30:00"; DateTimeFormatter parser = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); LocalDateTime parsed = LocalDateTime.parse(dateStr, parser); String dateOnlyStr = "2023-10-27"; LocalDate parsedDate = LocalDate.parse(dateOnlyStr, DateTimeFormatter.ISO_LOCAL_DATE);
如果字符串格式與解析器不匹配，會拋出DateTimeParseException。在處理用戶輸入或外部數據時，務必做好異常處理。DateTimeFormatter是線程安全的，所以你可以把它定義為常量或靜態變量，在整個應用中復用。這與舊的SimpleDateFormat形成了鮮明對比，后者每次使用都建議重新創建，以避免線程問題。
