“date format not recognized”（日期格式未被识别）**不是 Python、Java 等主流语言的原生标准错误信息**，而是**常见于特定数据库系统或解析库中的报错提示**，尤其高频出现在以下场景中： --- ### ✅ 最常见来源：**Oracle 数据库** 在 Oracle 中执行类似 `TO_DATE('2024-03-15', 'YYYY-MM-DD')` 或插入/查询含日期字符串的 SQL 时，若传入的字符串格式与指定格式模型（format mask）不匹配，Oracle 会抛出： ```text ORA-01861: literal does not match format string -- 或更直白的客户端/驱动层提示（如某些 JDBC/ODBC 封装、SQL Developer、DBeaver）显示为： "date format not recognized" ``` ⚠️ 注意：Oracle 官方错误码是 `ORA-01861`，但许多图形化工具或 ORM（如 SQLAlchemy + cx_Oracle）会将其简化/本地化为 “date format not recognized”。 --- ### ✅ 其他常见来源： | 环境 | 触发原因 | 示例 | |------|----------|------| | **PostgreSQL** | 使用 `TO_DATE()` 但格式串不合法（如用 `YYYY-MM-DD` 解析 `'15/03/2024'`） | `SELECT TO_DATE('15/03/2024', 'YYYY-MM-DD');` → 报错 | | **Apache Spark (PySpark)** | `to_date(col, format)` 中 `format` 不符合 [SimpleDateFormat](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) 规则（如误用 `yyyy-mm-dd` 而非 `yyyy-MM-dd`） | `df.withColumn("d", to_date("s", "yyyy-mm-dd"))` ❌（小写 `mm` 是分钟，非月份）→ 解析失败 | | **Java `DateTimeFormatter`** | 使用了错误 pattern（如 `yyyy-mm-dd`），`mm` 表示 *minute*，月份应为 `MM` | `DateTimeFormatter.ofPattern("yyyy-mm-dd")` → 解析 `"2024-03-15"` 时可能静默错误或抛 `DateTimeParseException`（但不会说 “not recognized”，需注意） | | **Python `pandas.to_datetime()`** | 当 `format=` 参数指定但字符串不匹配，且 `errors='raise'`（默认）时，抛 `ValueError: time data ... does not match format ...` —— **虽不叫 “not recognized”，但语义等价** | `pd.to_datetime('2024/03/15', format='%Y-%m-%d')` ❌（斜杠不匹配短横线） | --- ### ✅ 快速诊断与修复方案（以最典型 Oracle / PySpark / Pandas 为例） #### 🔹 场景 1：Oracle SQL 报 “date format not recognized” ```sql -- ❌ 错误：字符串含时间，但格式串只写了日期 INSERT INTO orders VALUES (1, TO_DATE('2024-03-15 14:30:00', 'YYYY-MM-DD')); -- ✅ 正确：格式串必须完全匹配字符串内容（含时分秒） INSERT INTO orders VALUES (1, TO_DATE('2024-03-15 14:30:00', 'YYYY-MM-DD HH24:MI:SS')); ``` #### 🔹 场景 2：PySpark `to_date()` 格式错误 ```python from pyspark.sql.functions import to_date, col # ❌ 错误：pattern 中 mm 是 minute，且大小写敏感；字符串是 '2024-03-15' df = df.withColumn("date_col", to_date(col("date_str"), "yyyy-mm-dd")) # ❌ 小写 mm # ✅ 正确：月份必须大写 MM，且 pattern 与字符串一致 df = df.withColumn("date_col", to_date(col("date_str"), "yyyy-MM-dd")) # ✅ # 或更健壮（自动推断）： df = df.withColumn("date_col", to_date(col("date_str"))) # ✅ 自动识别常见格式 ``` #### 🔹 场景 3：Pandas `to_datetime()` 失败 ```python import pandas as pd # ❌ 字符串是 '2024/03/15'，但 format 写成 '%Y-%m-%d' s = pd.Series(['2024/03/15']) pd.to_datetime(s, format='%Y-%m-%d') # ValueError # ✅ 方案1：修正 format pd.to_datetime(s, format='%Y/%m/%d') # ✅ # ✅ 方案2：不指定 format，让 pandas 自动推断（推荐） pd.to_datetime(s) # ✅ 自动支持多种分隔符 # ✅ 方案3：容错处理（跳过错误） pd.to_datetime(s, errors='coerce') # 错误值转为 NaT ``` --- ### 💡 核心原则（牢记！） 1. **格式串（format pattern）必须与原始字符串 *逐字符结构一致***：分隔符（`-` `/` `.`）、顺序（年月日 vs 日月年）、位数（`YYYY` vs `YY`）、大小写（`MM` 月 vs `mm` 分钟）。 2. **优先使用自动解析**（如 `pd.to_datetime()` 无 `format=`、Spark `to_date(col)` 无 pattern），除非性能/确定性要求强制指定。 3. **查文档确认 pattern 语法**： - Java/Spark：[SimpleDateFormat pattern letters](https://spark.apache.org/docs/latest/sql-ref-datetime-pattern.html) - Python：[strftime directives](https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior) - Oracle：[Datetime Format Models](https://docs.oracle.com/en/database/oracle/oracle-database/19/sqlrf/Format-Models.html) ---