当前位置：首页 > backend >正文

Java时间API终极指南

backend 2025/6/30 6:05:47

Java 时间 API 概述

Java 提供了多个时间相关的 API，主要包括 java.util.Date、java.util.Calendar、java.time 包（Java 8 引入）。其中，java.time 是最现代且功能最全面的时间 API。以下分为新旧 API 分别介绍。

`java.time` 包（Java 8+ 推荐使用）

java.time 包分为多个类，包括 LocalDate、LocalTime、LocalDateTime、ZonedDateTime 等。

LocalDate（仅日期）

// 无参构造：获取当前日期
LocalDate today = LocalDate.now();
System.out.println("Today: " + today); // 输出：2023-10-05// 有参构造：指定日期
LocalDate specificDate = LocalDate.of(2023, 10, 1);
System.out.println("Specific Date: " + specificDate); // 输出：2023-10-01// 成员方法示例
LocalDate tomorrow = today.plusDays(1); // 增加 1 天
System.out.println("Tomorrow: " + tomorrow);int year = today.getYear(); // 获取年份
System.out.println("Year: " + year);

LocalTime（仅时间）

// 无参构造：获取当前时间
LocalTime currentTime = LocalTime.now();
System.out.println("Current Time: " + currentTime); // 输出：14:30:15.123// 有参构造：指定时间
LocalTime specificTime = LocalTime.of(12, 30, 45);
System.out.println("Specific Time: " + specificTime); // 输出：12:30:45// 成员方法示例
LocalTime laterTime = currentTime.plusHours(2); // 增加 2 小时
System.out.println("Later Time: " + laterTime);int hour = specificTime.getHour(); // 获取小时
System.out.println("Hour: " + hour);

LocalDateTime（日期 + 时间）

// 无参构造：获取当前日期和时间
LocalDateTime now = LocalDateTime.now();
System.out.println("Now: " + now); // 输出：2023-10-05T14:30:15.123// 有参构造：指定日期时间
LocalDateTime specificDateTime = LocalDateTime.of(2023, 10, 1, 12, 30);
System.out.println("Specific DateTime: " + specificDateTime); // 输出：2023-10-01T12:30// 成员方法示例
LocalDateTime nextMonth = now.plusMonths(1); // 增加 1 个月
System.out.println("Next Month: " + nextMonth);int dayOfMonth = specificDateTime.getDayOfMonth(); // 获取日
System.out.println("Day: " + dayOfMonth);

ZonedDateTime（带时区的日期时间）

// 无参构造：获取当前时区的日期时间
ZonedDateTime zonedNow = ZonedDateTime.now();
System.out.println("Zoned Now: " + zonedNow); // 输出：2023-10-05T14:30:15.123+08:00[Asia/Shanghai]// 有参构造：指定时区
ZoneId zoneId = ZoneId.of("America/New_York");
ZonedDateTime newYorkTime = ZonedDateTime.now(zoneId);
System.out.println("New York Time: " + newYorkTime); // 输出：2023-10-05T02:30:15.123-04:00[America/New_York]// 成员方法示例
ZoneId currentZone = zonedNow.getZone(); // 获取时区
System.out.println("Current Zone: " + currentZone);

`java.util.Date`（旧 API，不推荐）

// 无参构造：当前时间
Date currentDate = new Date();
System.out.println("Current Date: " + currentDate); // 输出：Thu Oct 05 14:30:15 CST 2023// 有参构造：指定时间（毫秒时间戳）
Date specificDate = new Date(1696491000000L);
System.out.println("Specific Date: " + specificDate); // 输出：Wed Oct 04 00:00:00 CST 2023// 成员方法示例
long timeInMillis = currentDate.getTime(); // 获取毫秒时间戳
System.out.println("Time in Millis: " + timeInMillis);

`java.util.Calendar`（旧 API，不推荐）

// 无参构造：当前时间
Calendar calendar = Calendar.getInstance();
System.out.println("Calendar Time: " + calendar.getTime()); // 输出：Thu Oct 05 14:30:15 CST 2023// 有参构造：指定日期（需先获取实例再设置）
Calendar specificCalendar = Calendar.getInstance();
specificCalendar.set(2023, Calendar.OCTOBER, 1); // 注意月份从 0 开始
System.out.println("Specific Calendar: " + specificCalendar.getTime()); // 输出：Sun Oct 01 14:30:15 CST 2023// 成员方法示例
int month = calendar.get(Calendar.MONTH); // 获取月份（0-11）
System.out.println("Month: " + month);calendar.add(Calendar.DAY_OF_MONTH, 5); // 增加 5 天
System.out.println("After 5 Days: " + calendar.getTime());