Java JDK8 时间 API 重构了时间处理逻辑，核心优势在于不可变对象带来的线程安全及语义化命名。主要涵盖 ZoneId 时区管理、Instant 时间戳、ZonedDateTime 带时区时间、LocalDate/Time/DateTime 日期时间操作、DateTimeFormatter 格式化解析以及 Period/Duration 时间间隔计算。相比 JDK7 的 Date 和 Calendar，新 API 更符合直觉且易于维护。
Date（表示时间） + SimpleDateFormat（格式化解析） + Calendar（日历操作）JDK8 基于 ISO 8601 标准重构了时间 API，把时间功能拆解得清晰易懂：
| 类别 | 核心类 | 作用 |
|---|---|---|
| 时区 | ZoneId | 表示时区（如 Asia/Shanghai） |
| 时间戳 | Instant | 表示 UTC 标准时间戳 |
| 带时区时间 | ZonedDateTime | 带时区的完整时间 |
| 纯日期 | LocalDate | 仅包含年月日 |
| 纯时间 | LocalTime | 仅包含时分秒纳秒 |
| 日期 + 时间 | LocalDateTime | 包含年月日时分秒 |
| 格式化解析 | DateTimeFormatter | 替代 SimpleDateFormat |
| 时间间隔 | Period/Duration/ChronoUnit | 计算两个时间的间隔 |
表示全球各个时区，解决不同地区时间偏移的问题，是处理跨时区时间的基础。
| 方法名 | 说明 |
|---|---|
ZoneId.systemDefault() | 获取系统默认时区 |
ZoneId.of(String zoneId) | 根据时区名获取指定时区 |
ZoneId.getAvailableZoneIds() | 获取 Java 支持的所有时区 |
import java.time.ZoneId;
import java.util.Set;
public class ZoneIdDemo {
public static void main(String[] args) {
// 1. 获取系统默认时区（国内通常是 Asia/Shanghai）
ZoneId defaultZone = ZoneId.systemDefault();
System.out.println("系统默认时区：" + defaultZone);
// 2. 获取指定时区
ZoneId shanghaiZone = ZoneId.of("Asia/Shanghai");
ZoneId tokyoZone = ZoneId.of("Asia/Tokyo");
// 3. 查看所有支持的时区（约 600 个）
Set<String> allZones = ZoneId.getAvailableZoneIds();
System.out.println("Java 支持的时区总数：" + allZones.size());
}
}
表示时间线上的一个瞬时点，对应 JDK7 的 Date 类，底层存储的是从 1970-01-01 00:00:00 UTC 开始的毫秒/纳秒数。
| 方法名 | 说明 |
|---|---|
Instant.now() | 获取当前 UTC 时间戳 |
Instant.ofEpochMilli(long) | 根据毫秒值构建 Instant |
Instant.ofEpochSecond(long) | 根据秒值构建 Instant |
atZone(ZoneId zone) | 为时间戳绑定指定时区 |
isBefore(Instant other) | 判断当前时间是否在参数时间之前 |
isAfter(Instant other) | 判断当前时间是否在参数时间之后 |
plusSeconds(long) / minusSeconds(long) | 增加/减少指定秒数 |
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZonedDateTime;
public class InstantDemo {
public static void main(String[] args) {
// 1. 获取当前 UTC 时间戳
Instant nowInstant = Instant.now();
System.out.println("当前 UTC 时间戳：" + nowInstant);
// 2. 根据毫秒值构建（0 毫秒对应 1970-01-01 00:00:00 UTC）
Instant zeroInstant = Instant.ofEpochMilli(0L);
System.out.println("0 毫秒对应的时间戳：" + zeroInstant);
// 3. 为时间戳绑定时区（转换为带时区的时间）
ZonedDateTime shanghaiTime = nowInstant.atZone(ZoneId.of("Asia/Shanghai"));
System.out.println("上海时区的当前时间：" + shanghaiTime);
// 4. 时间比较
Instant oneSecond = Instant.ofEpochSecond(1L);
boolean isBefore = zeroInstant.isBefore(oneSecond); // true
boolean isAfter = zeroInstant.isAfter(oneSecond); // false
System.out.println("0 秒是否在 1 秒之前：" + isBefore);
// 5. 时间加减
Instant addInstant = zeroInstant.plusSeconds(3600); // 加 1 小时
System.out.println("加 1 小时后的时间：" + addInstant);
}
}
| 方法类型 | 核心方法 | 说明 |
|---|---|---|
| 获取对象 | ZonedDateTime.now() | 获取当前带时区时间 |
ZonedDateTime.of(年，月，日，时，分，秒，纳秒，时区) | 指定时间创建对象 | |
ZonedDateTime.ofInstant(Instant, ZoneId) | 通过时间戳 + 时区创建 | |
| 修改时间 | withYear(int) / withMonth(int) | 修改年/月（返回新对象） |
| 增减时间 | plusYears(long) / minusMonths(long) | 增加/减少年/月（返回新对象） |
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZonedDateTime;
public class ZonedDateTimeDemo {
public static void main(String[] args) {
// 1. 获取当前带时区时间
ZonedDateTime nowZoned = ZonedDateTime.now();
System.out.println("当前带时区时间：" + nowZoned);
// 2. 指定时间创建
ZonedDateTime customTime = ZonedDateTime.of(2026, 10, 1,
11, 11, 11, 0,
ZoneId.of("Asia/Shanghai"));
System.out.println("指定的上海时间：" + customTime);
// 3. 通过 Instant+ 时区创建
Instant instant = Instant.ofEpochMilli(0L);
ZonedDateTime zeroZoned = ZonedDateTime.ofInstant(instant, ZoneId.of("Asia/Shanghai"));
System.out.println("0 毫秒对应的上海时间：" + zeroZoned);
// 4. 修改时间（返回新对象，原对象不变）
ZonedDateTime modifyYear = customTime.withYear(2025);
ZonedDateTime minusMonth = modifyYear.minusMonths(1);
System.out.println("修改并减 1 个月后的时间：" + minusMonth);
}
}
替代 JDK7 的 SimpleDateFormat，解决了线程不安全的问题，是 JDK8 推荐的时间格式化工具。
| 方法名 | 说明 |
|---|---|
DateTimeFormatter.ofPattern(String) | 根据指定格式创建格式化器 |
format(TemporalAccessor temporal) | 将时间对象格式化为字符串 |
常用格式模板：
yyyy-MM-dd：仅日期（如 2026-02-20）HH:mm:ss：仅时间（如 15:30:45）yyyy-MM-dd HH:mm:ss：日期 + 时间（如 2026-02-20 15:30:45）import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
public class DateTimeFormatterDemo {
public static void main(String[] args) {
// 1. 获取带时区的当前时间
ZonedDateTime now = ZonedDateTime.now();
// 2. 创建格式化器（指定格式）
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
// 3. 格式化时间（时间对象 → 字符串）
String formatTime = formatter.format(now);
System.out.println("格式化后的时间：" + formatTime);
}
}
这三个类是 JDK8 时间 API 中日常开发使用频率最高的，按功能拆分，满足不同场景需求。
| 类名 | 包含信息 | 适用场景 |
|---|---|---|
| LocalDate | 年、月、日 | 生日、签到日期、订单日期 |
| LocalTime | 时、分、秒、纳秒 | 上下班打卡时间、活动开始时间 |
| LocalDateTime | 年、月、日、时、分、秒 | 日志记录、接口请求时间、数据创建时间 |
| 方法类型 | 核心方法 | 说明 |
|---|---|---|
| 获取对象 | XXX.now() | 获取当前时间/日期 |
XXX.of(...) | 指定时间/日期创建对象 | |
| 获取字段 | getYear() / getMonthValue() | 获取年/月（月份 1-12） |
getDayOfMonth() / getHour() | 获取日/时 | |
| 修改时间 | withYear(int) / withDayOfMonth(int) | 修改年/日 |
| 增减时间 | plusDays(long) / minusHours(long) | 增加/减少天/小时 |
| 时间比较 | isBefore(XXX) / isAfter(XXX) | 判断时间先后 |
import java.time.LocalDate;
import java.time.DayOfWeek;
public class LocalDateDemo {
public static void main(String[] args) {
// 1. 获取当前日期
LocalDate today = LocalDate.now();
System.out.println("今天的日期：" + today);
// 2. 指定日期创建
LocalDate customDate = LocalDate.of(2026, 1, 1);
System.out.println("指定日期：" + customDate);
// 3. 获取日期字段
int year = customDate.getYear(); // 2026
int month = customDate.getMonthValue(); // 1（1-12，无需 +1）
int day = customDate.getDayOfMonth(); // 1
DayOfWeek week = customDate.getDayOfWeek(); // 星期几
System.out.println(year + "年" + month + "月" + day + "日 星期" + week.getValue());
// 4. 时间比较
boolean isBefore = today.isBefore(customDate);
System.out.println("今天是否在 2026-01-01 之前：" + isBefore);
// 5. 时间修改与增减
LocalDate modifyDate = customDate.withYear(2025); // 修改年
LocalDate addDate = modifyDate.plusMonths(3); // 加 3 个月
System.out.println("修改并加 3 个月后的日期：" + addDate);
}
}
LocalDateTime 可以拆分为 LocalDate 和 LocalTime：
import java.time.LocalDateTime;
public class LocalConvertDemo {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
// LocalDateTime → LocalDate
LocalDate date = now.toLocalDate();
// LocalDateTime → LocalTime
LocalTime time = now.toLocalTime();
System.out.println("拆分出的日期：" + date);
System.out.println("拆分出的时间：" + time);
}
}
日常开发中经常需要计算两个时间的间隔，JDK8 提供了三个工具类，满足不同粒度的需求。
import java.time.LocalDate;
import java.time.Period;
public class PeriodDemo {
public static void main(String[] args) {
// 起始日期
LocalDate start = LocalDate.of(2020, 1, 1);
// 结束日期
LocalDate end = LocalDate.now();
// 计算间隔
Period period = Period.between(start, end);
System.out.println("年差：" + period.getYears());
System.out.println("月差：" + period.getMonths());
System.out.println("日差：" + period.getDays());
System.out.println("总月数：" + period.toTotalMonths());
}
}
import java.time.LocalDateTime;
import java.time.Duration;
public class DurationDemo {
public static void main(String[] args) {
// 起始时间
LocalDateTime start = LocalDateTime.of(2020, 1, 1, 0, 0);
// 结束时间
LocalDateTime end = LocalDateTime.now();
// 计算间隔
Duration duration = Duration.between(start, end);
System.out.println("天差：" + duration.toDays());
System.out.println("小时差：" + duration.toHours());
System.out.println("分钟差：" + duration.toMinutes());
System.out.println("毫秒差：" + duration.toMillis());
}
}
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
public class ChronoUnitDemo {
public static void main(String[] args) {
// 起始时间
LocalDateTime start = LocalDateTime.of(2007, 8, 13, 14, 0);
// 结束时间
LocalDateTime end = LocalDateTime.now();
// 计算不同单位的间隔
long years = ChronoUnit.YEARS.between(start, end);
long months = ChronoUnit.MONTHS.between(start, end);
long days = ChronoUnit.DAYS.between(start, end);
long hours = ChronoUnit.HOURS.between(start, end);
System.out.println("年差：" + years);
System.out.println("月差：" + months);
System.out.println("天差：" + days);
System.out.println("小时差：" + hours);
}
}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online