
本文详解如何将形如 "20220321211529042" 的数据库时间戳字符串正确解析并格式化为 "21/03/2022" 这样的纯日期格式,避免 `cannot format given object as a date` 错误。
在 Java 中处理数据库中存储的“时间戳”时,需特别注意:该字段本质上是字符串(如 "20220321211529042"),而非 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
假设从数据库获取的时间字段值为字符串 "20220321211529042"(共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., "20220321211529042"
LocalDateTime dateTime = LocalDateTime.parse(dbTimestampStr, inputFormatter);
// 4. 格式化为所需日期字符串
String formattedDate = dateTime.format(outputFormatter); // → "21/03/2022"
// 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/2022" | 严格匹配 dd/MM/yyyy 模式 |
遵循此方法,即可稳定、高效、可维护地完成数据库时间戳字符串到标准日期格式的转换。










