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形成了鲜明对比，后者每次使用都建议重新创建，以避免线程问题。
