本文共 4760 字，大约阅读时间需要 15 分钟。
Java的日期时间处理类在之前的版本中存在诸多痛点，主要体现在以下几个方面：
线程安全问题：Date 和 Calendar 类均为可变类，其线程安全性需手动处理，Java8新引入的日期时间类则采用不可变设计，天然具备线程安全特性。
API设计不合理：不同包中的日期时间类（如java.util.Date、java.sql.Date）名称重复，且功能定位不清，java.util.Date 同时包含日期和时间，而java.sql.Date 仅处理日期，导致混淆。
时区处理缺失：旧API缺乏国际化支持，Calendar 和 TimeZone 类虽提供时区功能，但同样存在线程安全问题。
Java8全面重新设计日期时间API，引入多个核心类别：
| 编号 | 类名 | 描述 |
|---|---|---|
| 1 | LocalDate | 只包含日期，格式如：2018-02-05 |
| 2 | LocalTime | 仅包含时间，格式如：23:12:10 |
| 3 | LocalDateTime | 同时包含日期和时间，格式如：2018-02-05 23:14:21 |
| 4 | Instant | 时间戳，精度可达纳秒（如2024-03-20T12:34:56.789Z） |
| 5 | Duration | 时间段，计算时间差（如1天、5小时） |
| 6 | Period | 以年、月、日为单位的时间段（如2年3个月） |
| 7 | ZoneOffset | 时区偏移量（如+8:00） |
| 8 | ZonedDateTime | 带时区的时间点（如2024-03-20T12:34:56+08:00） |
| 9 | Clock | 时钟实例，可指定时区（如获取上海时间） |
| 10 | DateTimeFormatter | 时间格式化工具（如YYYY-MM-DD、HH:mm:ss.SSS） |
LocalDate表示具体日期，不含时间和时区。
LocalDate now = LocalDate.now(); // 获取当前日期LocalDate localDate = LocalDate.of(2017, 1, 4); // 初始化日期：2017-01-04int year = localDate.getYear(); // 年份：2017Month month = localDate.getMonth(); // 月份：JANUARYint dayOfMonth = localDate.getDayOfMonth(); // 当月的第几天：4DayOfWeek dayOfWeek = localDate.getDayOfWeek(); // 一周中的第几天：WEDNESDAYint length = localDate.lengthOfMonth(); // 月份的天数：31boolean leapYear = localDate.isLeapYear(); // 是否为闰年：false
LocalTime只包含时间，不含日期。
LocalTime now = LocalTime.now(); // 获取当前时间LocalTime localTime = LocalTime.of(17, 23, 52); // 初始化时间：17:23:52int hour = localTime.getHour(); // 时：17int minute = localTime.getMinute(); // 分：23int second = localTime.getSecond(); // 秒：52
LocalDateTime同时包含日期和时间。
LocalDateTime now = LocalDateTime.now(); // 当前日期时间LocalDateTime ldt1 = LocalDateTime.of(2017, Month.JANUARY, 4, 17, 23, 52); // 2017-01-04 17:23:52LocalDate localDate = LocalDate.now();LocalTime localTime = LocalTime.now();LocalDateTime ldt2 = localDate.atTime(localTime); // 将日期与时间合并LocalDate localDate1 = ldt1.toLocalDate(); // 转化为日期LocalTime localTime1 = ldt1.toLocalTime(); // 转化为时间
Instant表示时间戳，支持纳秒精度。
Instant now = Instant.now(); // 获取当前时间戳long l = now.toEpochMilli(); // 转换为毫秒数
Duration表示时间段，支持天、小时、分钟、秒等单位。
LocalDateTime from = LocalDateTime.of(2017, Month.JANUARY, 5, 10, 7, 0); // 2017-01-05 10:07:00LocalDateTime to = LocalDateTime.of(2017, Month.FEBRUARY, 5, 10, 7, 0); // 2017-02-05 10:07:00Duration duration = Duration.between(from, to); // 计算时间差long days = duration.toDays(); // 总天数long hours = duration.toHours(); // 小时数long minutes = duration.toMinutes(); // 分钟数long seconds = duration.getSeconds(); // 秒数long milliSeconds = duration.toMillis(); // 毫秒数long nanoSeconds = duration.toNanos(); // 纳秒数
Period用于表示年月日级别的时间段。
Period period2 = Period.of(2, 3, 6); // 2年3个月6天Period period = Period.between(LocalDate.of(2017, 1, 5), LocalDate.of(2018, 2, 5)); // 2017-01-05 到 2018-02-05
LocalDate date = LocalDate.of(2017, 1, 5); // 2017-01-05LocalDate date1 = date.withYear(2016); // 2016-01-05LocalDate date2 = date.withMonth(2); // 2017-02-05LocalDate date3 = date.withDayOfMonth(1); // 2017-01-01LocalDate date4 = date.plusYears(1); // 2018-01-05LocalDate date5 = date.minusMonths(2); // 2016-11-05LocalDate date6 = date.plus(5, ChronoUnit.DAYS); // 2017-01-10// 特殊操作LocalDate date7 = date.with(nextOrSame(DayOfWeek.SUNDAY)); // 下一个星期日LocalDate date9 = date.with(lastInMonth(DayOfWeek.SATURDAY)); // 本月最后一个星期六
LocalDateTime dateTime = LocalDateTime.now();String strDate1 = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE); // 20170105String strDate2 = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE); // 2017-01-05String strDate3 = dateTime.format(DateTimeFormatter.ISO_LOCAL_TIME); // 14:20:16.998String strDate4 = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")); // 2017-01-05String strDate5 = dateTime.format(DateTimeFormatter.ofPattern("今天是：YYYY年 MMMM DD日 E", Locale.CHINESE)); // 今天是：2017年 一月 05日 星期四// 解析日期String strDate6 = "2017-01-05";LocalDate date = LocalDate.parse(strDate6, DateTimeFormatter.ofPattern("yyyy-MM-dd"));String strDate7 = "2017-01-05 12:30:05";LocalDateTime dateTime1 = LocalDateTime.parse(strDate7, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")); 时区处理采用新的API，支持国际化。
ZoneId shanghaiZoneId = ZoneId.of("Asia/Shanghai"); // 上海时区ZoneId systemZoneId = ZoneId.systemDefault(); // 系统默认时区String zoneIds = ZoneId.getAvailableZoneIds(); // 获取所有时区IDLocalDateTime localDateTime = LocalDateTime.now();ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, shanghaiZoneId); // 包含时区日期时间// 通过偏移量表示时区ZoneOffset zoneOffset = ZoneOffset.of("+09:00");LocalDateTime localDateTime = LocalDateTime.now();OffsetDateTime offsetDateTime = OffsetDateTime.of(localDateTime, zoneOffset); 转载地址：http://uphwz.baihongyu.com/