Java日期时间应优先使用java.time包：LocalDateTime用于无时区业务计算，ZonedDateTime用于时区敏感场景，Instant作为UTC时间基准，Duration/Period分别处理精确时段和人可读日期差。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
<p>Java 日期时间核心 API 的关键在于区分 <strong>旧版（java.util.Date / Calendar）</strong> 和 <strong>新版（java.time.*，Java 8+ 推荐）</strong>。日常开发优先用 java.time，它线程安全、语义清晰、设计合理。</p>
<H3>常用类速查（java.time 包）</H3>
<p><strong>LocalDateTime</strong>：无时区的日期+时间（如“2024-05-20 14:30:45”）<br>
→ 适合数据库存储（不带时区）、业务逻辑内部计算<br>
→ 不可用于跨系统时间传递或日志记录（缺少时区信息）</p>
<p><strong>ZonedDateTime</strong>：带时区的完整时间（如“2024-05-20T14:30:45+08:00[Asia/Shanghai]”）<br>
→ 适合用户界面展示、本地化时间处理、跨时区调度</p>
<p><strong>Instant</strong>：UTC 时间戳（从 1970-01-01T00:00:00Z 开始的纳秒数）<br>
→ 适合系统间通信、日志打点、数据库中统一存储时间基准<br>
→ 所有服务器应以 Instant 为“事实真相”，显示时再转 ZonedDateTime</p>
<p><strong>Duration / Period</strong>：<br>
• Duration 表示精确到纳秒的时间段（基于秒+纳秒，适合计算两个 Instant 间隔）<br>
• Period 表示年月日层级的日期差（如“2年3个月5天”，适合人眼可读的业务规则）</p>
<H3>高频操作代码模板</H3>
<p><strong>当前时间</strong><br>
• 系统默认时区：LocalDateTime.now()<br>
• 指定时区：ZonedDateTime.now(ZoneId.of("Europe/London"))<br>
• UTC 时间戳：Instant.now()</p>
<p><strong>字符串 ↔ 时间对象</strong><br>
• 解析 ISO 格式（如 "2024-05-20T14:30:45"）：LocalDateTime.parse(str)<br>
• 解析自定义格式：DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").parse(str)<br>
• 格式化输出：localDateTime.format(DateTimeFormatter.ofPattern("MM/dd/yyyy"))</p>
<p><strong>时间运算</strong><br>
• 加3天：localDateTime.plusDays(3)<br>
• 减2小时：zonedDateTime.minusHours(2)<br>
• 到下个月第一天：localDate.withDayOfMonth(1).plusMonths(1)</p>
<H3>避坑提醒</H3>
<p>• <strong>别混用新旧 API</strong>：Date 和 LocalDateTime 之间必须通过 Instant 中转（new Date().toInstant() → LocalDateTime.ofInstant(..., ZoneId.systemDefault())）</p>
<p>• <strong>时区不是字符串匹配</strong>：ZoneId.of("GMT+8") ❌，要用 ZoneOffset.of("+08:00") 或 ZoneId.of("Asia/Shanghai") ✅</p>
<p>• <strong>系统默认时区不可靠</strong>：服务器可能被修改，生产环境建议显式传入 ZoneId，如 ZoneId.of("Asia/Shanghai")</p>
<p>• <strong>MySQL DATETIME vs TIMESTAMP</strong>：<br>
– DATETIME 存的是字面值（无时区），读写都按应用所在 JVM 时区解释 → 建议存 LocalDateTime + 显式时区约定<br>
– TIMESTAMP 存的是 UTC，读写自动转时区 → 配合 Instant 使用更安全</p>
<H3>兼容 Java 7 及以下？</H3>
<p>• 用 <font color="red">ThreeTen-Backport</font> 库（org.threeten:threetenbp），提供 java.time 的完整 backport<br>
• Android 开发用 <font color="red">ThreeTenABP</font>（适配 Android API 级别）<br>
• 避免继续用 Calendar —— 它线程不安全、API 反直觉、月份从 0 开始等陷阱太多</p> 
