如何将数据库中的时间戳字符串格式化为 dd/MM/yyyy 日期格式_技术教程

本文详解如何将形如 "20250321211529042" 的数据库时间戳字符串正确解析并格式化为 "21/03/2025" 这样的纯日期格式，避免 `cannot format given object as a date` 错误。

在 Java 中处理数据库中存储的“时间戳”时，需特别注意：该字段本质上是字符串（如 "20250321211529042"），而非 java.sql.Timestamp 或 Instant 等真正的时间类型。直接对字符串调用 SimpleDateFormat.format() 会抛出 IllegalArgumentException: Cannot format given Object as a Date —— 因为 format() 方法只接受 Date 及其子类，而你传入的是 String。

✅ 正确做法是：先解析（parse）原始字符串为时间对象，再格式化（format）输出。推荐使用现代 Java 时间 API（java.time），它线程安全、语义清晰且不易出错。

✅ 推荐方案：使用 LocalDateTime + DateTimeFormatter

假设从数据库获取的时间字段值为字符串 "20250321211529042"（共17位：yyyyMMddHHmmssSSS），可按如下步骤处理：

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

// 1. 定义输入格式（原始字符串模式）
DateTimeFormatter inputFormatter = DateTimeFormatter.ofPattern("uuuuMMddHHmmssSSS");
// 2. 定义输出格式（目标日期格式）
DateTimeFormatter outputFormatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");

// 3. 解析字符串为 LocalDateTime（注意：无时区信息，适用于本地时间语义）
String dbTimestampStr = db.getDataAt(i, "date_column_from_db"); // e.g., "20250321211529042"
LocalDateTime dateTime = LocalDateTime.parse(dbTimestampStr, inputFormatter);

// 4. 格式化为所需日期字符串
String formattedDate = dateTime.format(outputFormatter); // → "21/03/2025"

// 5. 设置到业务对象
xi.setItem("Dte", formattedDate);

⚠️ 注意事项

不要混用旧 API：SimpleDateFormat 是线程不安全的，且 format(String) 方法根本不存在（它只有 format(Date)），因此原代码 new SimpleDateFormat("dd/MM/yyyy").format("date_column_from_db") 必然编译失败或运行时报错。
区分 uuuu 与 yyyy：在 DateTimeFormatter 中，推荐使用 uuuu 表示“基于周的年”，对大多数场景更鲁棒；若仅处理公历年份，yyyy 也可用，但 uuuu 是官方推荐。
精度与截断：原始字符串含毫秒（SSS），但目标格式只需日期，LocalDateTime.parse() 自动忽略时间部分的语义歧义，仅按字面解析，完全符合需求。
异常处理：生产环境务必包裹 try-catch，捕获 DateTimeParseException 并做日志或默认值兜底：

try {
    LocalDateTime dateTime = LocalDateTime.parse(dbTimestampStr, inputFormatter);
    xi.setItem("Dte", dateTime.format(outputFormatter));
} catch (DateTimeParseException e) {
    log.warn("Invalid timestamp string: {}", dbTimestampStr, e);
    xi.setItem("Dte", "N/A");
}

✅ 总结

步骤	操作	关键点
❌ 错误做法	对字符串直接调用 format()	SimpleDateFormat.format() 不接受 String
✅ 正确流程	String → LocalDateTime.parse() → .format()	使用 java.time，明确解析+格式化两步
? 输出目标	"21/03/2025"	严格匹配 dd/MM/yyyy 模式