日期时间 API

news2025/3/1 8:33:51

日期时间 API (java.time 包)，旨在解决旧版 java.util.Date 和 java.util.Calendar 存在的一些设计缺陷，比如线程不安全、时区处理不一致等问题。新 API 基于 ISO 8601 标准，更加直观、简洁，且支持时区和区域设置。主要类有：LocalDate、LocalTime、LocalDateTime、ZonedDateTime、Instant、Duration、Period 等。

1. LocalDate：表示日期（无时区）

LocalDate 用于表示没有时间部分和时区的日期（如：年-月-日）。

创建 LocalDate 实例

import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        // 当前日期
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期: " + today);

        // 指定日期
        LocalDate specificDate = LocalDate.of(2025, 5, 15);
        System.out.println("指定日期: " + specificDate);

        // 从字符串创建
        LocalDate fromString = LocalDate.parse("2025-05-15");
        System.out.println("从字符串创建: " + fromString);
    }
}

常用方法

now()：获取当前日期。
of(year, month, day)：创建指定日期。
plusDays(long days)：增加天数。
minusMonths(long months)：减少月份。
getDayOfWeek()：获取星期几。

2. LocalTime：表示时间（无日期、无时区）

LocalTime 表示一天中的时间（小时、分钟、秒），不涉及日期和时区。

创建 LocalTime 实例

import java.time.LocalTime;

public class LocalTimeExample {
    public static void main(String[] args) {
        // 当前时间
        LocalTime now = LocalTime.now();
        System.out.println("当前时间: " + now);

        // 指定时间
        LocalTime specificTime = LocalTime.of(14, 30);
        System.out.println("指定时间: " + specificTime);

        // 从字符串创建
        LocalTime fromString = LocalTime.parse("14:30:15");
        System.out.println("从字符串创建: " + fromString);
    }
}

常用方法

now()：获取当前时间。
of(hour, minute)：创建指定时间。
plusMinutes(long minutes)：增加分钟。
minusSeconds(long seconds)：减少秒数。
getHour()：获取小时。

3. LocalDateTime：表示日期和时间（无时区）

LocalDateTime 结合了 LocalDate 和 LocalTime，表示日期和时间，依然不涉及时区。

创建 LocalDateTime 实例

import java.time.LocalDateTime;

public class LocalDateTimeExample {
    public static void main(String[] args) {
        // 当前日期和时间
        LocalDateTime now = LocalDateTime.now();
        System.out.println("当前日期和时间: " + now);

        // 指定日期和时间
        LocalDateTime specificDateTime = LocalDateTime.of(2025, 5, 15, 14, 30);
        System.out.println("指定日期和时间: " + specificDateTime);

        // 从字符串创建
        LocalDateTime fromString = LocalDateTime.parse("2025-05-15T14:30:00");
        System.out.println("从字符串创建: " + fromString);
    }
}

常用方法

now()：获取当前日期和时间。
of(year, month, day, hour, minute)：创建指定日期和时间。
plusHours(long hours)：增加小时数。
minusMinutes(long minutes)：减少分钟数。
getYear()：获取年份。

4. ZonedDateTime：表示带时区的日期和时间

ZonedDateTime 表示带有时区的日期时间，它可以精确到不同的时区，适用于跨时区的场景。

创建 ZonedDateTime 实例

import java.time.ZonedDateTime;
import java.time.ZoneId;

public class ZonedDateTimeExample {
    public static void main(String[] args) {
        // 当前时区的当前时间
        ZonedDateTime now = ZonedDateTime.now();
        System.out.println("当前时区时间: " + now);

        // 指定时区的当前时间
        ZonedDateTime timeInLondon = ZonedDateTime.now(ZoneId.of("Europe/London"));
        System.out.println("伦敦的当前时间: " + timeInLondon);

        // 创建指定时间和时区
        ZonedDateTime specificDateTime = ZonedDateTime.of(2025, 5, 15, 14, 30, 0, 0, ZoneId.of("Asia/Shanghai"));
        System.out.println("指定时间和时区: " + specificDateTime);
    }
}

常用方法

now()：获取当前时间和时区。
of(year, month, day, hour, minute, second, nanoOfSecond, zone)：创建指定时区的日期和时间。
plusHours(long hours)：增加小时数。
withZoneSameInstant(ZoneId zone)：调整为指定时区的时间。
getZone()：获取时区信息。

5. Instant：表示时间戳（自1970年1月1日起的秒数）

Instant 表示时间点，通常用于时间戳。它是自 UNIX 纪元（1970年1月1日）以来的秒数。适用于精确时间和存储时间。

创建 Instant 实例

import java.time.Instant;

public class InstantExample {
    public static void main(String[] args) {
        // 当前时间戳
        Instant now = Instant.now();
        System.out.println("当前时间戳: " + now);

        // 从秒数创建
        Instant specificInstant = Instant.ofEpochSecond(1672531199);
        System.out.println("指定时间戳: " + specificInstant);
    }
}

常用方法

now()：获取当前的时间戳。
ofEpochSecond(long epochSecond)：通过给定的秒数创建 Instant。
plusSeconds(long seconds)：增加秒数。
minusMillis(long millis)：减少毫秒数。
toEpochMilli()：返回自 Unix 纪元以来的毫秒数。

6. Duration 和 Period

Duration 用于表示时间上的差异，通常用于秒和纳秒级别的操作。
Period 用于表示日期上的差异，通常用于年、月和日。

Duration 示例

import java.time.Duration;
import java.time.LocalTime;

public class DurationExample {
    public static void main(String[] args) {
        LocalTime startTime = LocalTime.of(10, 30);
        LocalTime endTime = LocalTime.of(12, 45);

        Duration duration = Duration.between(startTime, endTime);
        System.out.println("持续时间（小时和分钟）: " + duration.toHours() + "小时 " + duration.toMinutes() % 60 + "分钟");
    }
}

Period 示例

import java.time.LocalDate;
import java.time.Period;

public class PeriodExample {
    public static void main(String[] args) {
        LocalDate startDate = LocalDate.of(2020, 1, 1);
        LocalDate endDate = LocalDate.of(2025, 5, 15);

        Period period = Period.between(startDate, endDate);
        System.out.println("日期差异: " + period.getYears() + "年 " + period.getMonths() + "月 " + period.getDays() + "天");
    }
}