深入掌握 Java 日期时间 API：从基础使用到高级实战（全解析）

// 旧API创建2026年3月20日，月份必须写2（0=1月）
Date date = new Date(2026-1900, 2, 20); 
// SimpleDateFormat多线程下直接报错
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");

import java.time.LocalDate;

public class LocalDateDemo {
    public static void main(String[] args) {
        // 1. 获取当前日期（系统默认时区）
        LocalDate now = LocalDate.now();
        System.out.println("当前日期：" + now);

        // 2. 指定日期（年、月、日），月份直接写数字，无需减1
        LocalDate指定日期 = LocalDate.of(2026, 3, 20);
        System.out.println("指定日期：" + 指定日期);

        // 3. 获取日期的年、月、日、星期
        int year = now.getYear(); // 年
        int month = now.getMonthValue(); // 月
        int day = now.getDayOfMonth(); // 日
        // 星期：MONDAY、TUESDAY...SUNDAY
        String week = now.getDayOfWeek().toString(); 

        // 4. 日期判断：是否闰年、是否在指定日期之前/之后
        boolean isLeapYear = now.isLeapYear(); // 是否闰年
        boolean isBefore = now.isBefore(LocalDate.of(2025, 1, 1));
    }
}

import java.time.LocalTime;

public class LocalTimeDemo {
    public static void main(String[] args) {
        // 1. 获取当前时间
        LocalTime now = LocalTime.now();
        System.out.println("当前时间：" + now);

        // 2. 指定时间（时、分、秒、纳秒）
        LocalTime 指定时间 = LocalTime.of(15, 30, 25);
        System.out.println("指定时间：" + 指定时间);

        // 3. 获取时间的时、分、秒
        int hour = now.getHour();
        int minute = now.getMinute();
        int second = now.getSecond();
    }
}

import java.time.LocalDateTime;

public class LocalDateTimeDemo {
    public static void main(String[] args) {
        // 1. 获取当前日期时间
        LocalDateTime now = LocalDateTime.now();
        System.out.println("当前日期时间：" + now);

        // 2. 指定日期时间
        LocalDateTime 指定时间 = LocalDateTime.of(2026, 3, 20, 15, 30, 25);
        System.out.println("指定日期时间：" + 指定时间);

        // 3. 拆分：转LocalDate / LocalTime
        LocalDate date = now.toLocalDate();
        LocalTime time = now.toLocalTime();
    }
}

import java.time.Instant;

public class InstantDemo {
    public static void main(String[] args) {
        // 1. 获取当前时间戳（UTC时间）
        Instant now = Instant.now();
        System.out.println("当前UTC时间戳：" + now);

        // 2. 转毫秒值（等价于System.currentTimeMillis()）
        long milli = now.toEpochMilli();
        System.out.println("毫秒值：" + milli);

        // 3. 毫秒值转Instant
        Instant ofEpochMilli = Instant.ofEpochMilli(milli);
    }
}

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class FormatDemo {
    public static void main(String[] args) {
        // 1. 获取当前日期时间
        LocalDateTime now = LocalDateTime.now();

        // 2. 创建格式化器（常用格式：yyyy-MM-dd HH:mm:ss）
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

        // 3. 格式化：日期 → 字符串
        String formatTime = now.format(formatter);
        System.out.println("格式化后：" + formatTime);
    }
}

public class ParseDemo {
    public static void main(String[] args) {
        // 待解析的字符串
        String timeStr = "2026-03-20 15:30:25";
        // 格式化器（必须与字符串格式一致）
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        
        // 解析：字符串 → 日期时间
        LocalDateTime parseTime = LocalDateTime.parse(timeStr, formatter);
        System.out.println("解析后：" + parseTime);
    }
}

LocalDateTime now = LocalDateTime.now();

// 加1天
LocalDateTime plusDays = now.plusDays(1);
// 减2小时
LocalDateTime minusHours = now.minusHours(2);
// 加1个月
LocalDateTime plusMonths = now.plusMonths(1);
// 加1年
LocalDateTime plusYears = now.plusYears(1);

LocalDate date1 = LocalDate.of(2026, 3, 20);
LocalDate date2 = LocalDate.of(2025, 12, 31);

// date1是否在date2之前
boolean before = date1.isBefore(date2); 
// date1是否在date2之后
boolean after = date1.isAfter(date2);  
// 日期是否相等
boolean equal = date1.isEqual(date2);  

import java.time.Duration;
import java.time.Period;

public class IntervalDemo {
    public static void main(String[] args) {
        // 1. 日期间隔（年月日）
        LocalDate startDate = LocalDate.of(2025, 1, 1);
        LocalDate endDate = LocalDate.of(2026, 3, 20);
        Period period = Period.between(startDate, endDate);
        System.out.println("间隔：" + period.getYears() + "年" + period.getMonths() + "月" + period.getDays() + "日");

        // 2. 时间间隔（时分秒）
        LocalTime startTime = LocalTime.of(10, 0, 0);
        LocalTime endTime = LocalTime.of(15, 30, 0);
        Duration duration = Duration.between(startTime, endTime);
        System.out.println("间隔小时：" + duration.toHours()); // 5小时
        System.out.println("间隔分钟：" + duration.toMinutes()); // 330分钟
    }
}

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

public class ZonedDemo {
    public static void main(String[] args) {
        // 1. 获取当前时区的日期时间
        ZonedDateTime now = ZonedDateTime.now();
        System.out.println("当前时区时间：" + now);

        // 2. 指定时区（北京时间）
        ZonedDateTime 北京时间 = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));
        System.out.println("北京时间：" + 北京时间);

        // 3. 时区转换（纽约时间 → 北京时间）
        ZonedDateTime 纽约时间 = ZonedDateTime.now(ZoneId.of("America/New_York"));
        ZonedDateTime 转换北京时间 = 纽约时间.withZoneSameInstant(ZoneId.of("Asia/Shanghai"));
    }
}

import java.util.Date;
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneId;

public class ConvertDemo {
    public static void main(String[] args) {
        // 1. Date → LocalDateTime
        Date date = new Date();
        LocalDateTime localDateTime = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();

        // 2. LocalDateTime → Date
        LocalDateTime now = LocalDateTime.now();
        Instant instant = now.atZone(ZoneId.systemDefault()).toInstant();
        Date newDate = Date.from(instant);
    }
}

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

/**
 * 日期时间工具类（Java 8+ 线程安全）
 */
public class DateUtils {

    // 标准日期格式：yyyy-MM-dd
    public static final String YYYY_MM_DD = "yyyy-MM-dd";
    // 标准日期时间格式：yyyy-MM-dd HH:mm:ss
    public static final String YYYY_MM_DD_HH_MM_SS = "yyyy-MM-dd HH:mm:ss";

    /**
     * LocalDateTime 转 字符串
     */
    public static String format(LocalDateTime dateTime, String pattern) {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return dateTime.format(formatter);
    }

    /**
     * 字符串 转 LocalDateTime
     */
    public static LocalDateTime parse(String dateStr, String pattern) {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalDateTime.parse(dateStr, formatter);
    }

    /**
     * 获取当前日期字符串（yyyy-MM-dd）
     */
    public static String getNowDate() {
        return LocalDate.now().format(DateTimeFormatter.ofPattern(YYYY_MM_DD));
    }

    /**
     * 获取当前日期时间字符串（yyyy-MM-dd HH:mm:ss）
     */
    public static String getNowDateTime() {
        return LocalDateTime.now().format(DateTimeFormatter.ofPattern(YYYY_MM_DD_HH_MM_SS));
    }
}