Java 中日期时间 API 经典实战案例怎么写-java教程-PHP中文网

java 8 java.time api通过四大实战案例解决高频痛点：1. 用户本地时间与服务器utc双向转换；2. 计算排除周末节假日的工作日天数；3. 安全解析多格式日期字符串；4. 生成过去n天零点时间范围列表，强调时区语义、instant存储及异常防护。

java 中日期时间 api 经典实战案例怎么写

Java 8 引入的 java.time API（JSR-310）彻底取代了老旧、线程不安全的 Date 和 SimpleDateFormat。写“经典实战案例”，关键不是罗列 API 方法，而是直击开发中真实高频痛点——比如时区转换、日期计算、字符串解析/格式化、跨系统时间一致性等。下面用四个典型场景展开，每例都带可直接运行的代码和关键说明。

处理用户本地时间与服务器 UTC 时间的双向转换

Web 应用常见需求：前端传来用户所在时区的“2024-05-20 14:30”，后端需存为 UTC 时间；查询时再转回用户时区展示。

核心要点：不用 LocalDateTime（它无时区），必须用 ZonedDateTime 或 Instant + 时区。

解析用户输入（带时区或隐含时区）→ 转为 ZonedDateTime
用 withZoneSameInstant(ZoneOffset.UTC) 转成 UTC 时间点
存储推荐用 Instant（数据库字段类型如 TIMESTAMP WITH TIME ZONE 或 BIGINT 存毫秒）

示例代码：

// 假设用户在东八区，提交 "2024-05-20 14:30"
String input = "2024-05-20 14:30";
ZoneId userZone = ZoneId.of("Asia/Shanghai");
LocalDateTime ldt = LocalDateTime.parse(input, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm"));
ZonedDateTime zdtUser = ldt.atZone(userZone);
Instant utcInstant = zdtUser.toInstant(); // → 2024-05-20T06:30:00Z

// 查库后还原给用户（仍用上海时区）
ZonedDateTime zdtForUser = utcInstant.atZone(userZone); // → 2024-05-20T14:30+08:00

计算两个日期之间的“工作日天数”（排除周末和节假日）

ChronoUnit.DAYS.between() 只算自然日，业务常需剔除周六日及法定假期。

核心要点：用 LocalDate 驱动循环，配合自定义节假日集合 + DayOfWeek 判断。

起止日期用 LocalDate（不涉及时区，语义清晰）
遍历每一天，跳过 SATURDAY/SUNDAY
节假日建议从配置或 DB 加载为 Set<localdate></localdate>，提升查找效率

示例逻辑片段：

js2java

JavaScript 到 Java 全栈翻译助手，专为前端开发者学习 Java 或快速实现后端业务逻辑而设计。当用户提到以下场景时必须使用此技能： - "帮我把这段 JS 代码转成 Java" - "用 Java 怎么写这个逻辑" - "我习惯用 JS 写，想翻译成 Java" - "教我 Java，我要写后端接...

下载

public long countWorkdays(LocalDate start, LocalDate end, Set<localdate> holidays) {
    long workdays = 0;
    LocalDate date = start;
    while (!date.isAfter(end)) {
        if (date.getDayOfWeek() != DayOfWeek.SATURDAY &&
            date.getDayOfWeek() != DayOfWeek.SUNDAY &&
            !holidays.contains(date)) {
            workdays++;
        }
        date = date.plusDays(1);
    }
    return workdays;
}
</localdate>

安全解析不确定格式的日期字符串（兼容多种输入）

用户输入、第三方接口返回的日期格式常不统一：“2024/05/20”、“2024-05-20T10:30:45”、“20240520”……硬写一个 DateTimeFormatter 容易抛异常。

核心要点：用“尝试法”逐个匹配预设格式列表，捕获 DateTimeParseException，避免程序中断。

把常用格式按优先级排序（如 ISO 格式放前面）
对每个格式调用 parseBest() 或手动 try-catch
统一返回 LocalDateTime 或 Instant，便于后续处理

简化版尝试逻辑：

public static TemporalAccessor parseFlexible(String text) {
    List<datetimeformatter> formatters = Arrays.asList(
        DateTimeFormatter.ISO_LOCAL_DATE_TIME,
        DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"),
        DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss"),
        DateTimeFormatter.ofPattern("yyyyMMddHHmmss"),
        DateTimeFormatter.ISO_LOCAL_DATE
    );
    for (DateTimeFormatter f : formatters) {
        try {
            return f.parse(text);
        } catch (DateTimeParseException ignored) {}
    }
    throw new IllegalArgumentException("Unparseable date: " + text);
}
</datetimeformatter>

生成“过去 N 天内每天零点”的时间范围列表（用于图表统计）

运营后台查近 7 天每日新增用户数，需生成 [2024-05-14 00:00:00, 2024-05-15 00:00:00) 这样的区间。

核心要点：用 LocalDate 计算日期偏移，再转为带时区的 ZonedDateTime 确保边界精确。

起点用 LocalDate.now().minusDays(n) 得到首日
对每一天调用 atStartOfDay(ZoneId.systemDefault()) 得当日零点
结束时间 = 下一日零点，用 plusDays(1) 更可靠，别用 +24h（夏令时可能出错）

示例（生成近 7 天区间）：

ZoneId zone = ZoneId.systemDefault();
LocalDate today = LocalDate.now();
List<pair instant>> ranges = new ArrayList();
for (int i = 6; i >= 0; i--) { // 倒序：今天、昨天…往前推6天
    LocalDate day = today.minusDays(i);
    ZonedDateTime start = day.atStartOfDay(zone);
    ZonedDateTime end = start.plusDays(1);
    ranges.add(Pair.of(start.toInstant(), end.toInstant()));
}
// ranges.get(0) 就是今天 [00:00, 明日00:00)
</pair>

这些案例覆盖了时间处理中最易踩坑的环节：时区混淆、工作日逻辑、格式容错、区间边界。记住一个原则：能用 LocalDate/LocalDateTime 就不用 Date；涉及时区必带 ZoneId；存库优先选 Instant；所有解析加 try-catch。API 不难，关键是建立“时间语义”的正确直觉。