通过ODBC读取HFSQL数据库日期字段报ValueError如何解决

这个报错和字段内存储的日期合法性、日期格式的日月顺序配置无关，是HFSQL ODBC驱动返回日期类型值时的填充规则和pyodbc/pypyodbc默认解析逻辑不兼容导致的：驱动返回的日期二进制值带空字符填充位，底层解析逻辑尝试将空字符串按整数解析截取字段长度时触发错误。从返回的字段元信息能看到驱动已经正确识别字段为datetime.date类型，只是传值阶段的格式对齐出了问题。

按优先级从高到低尝试：

• 优先修改ODBC连接串，追加两个兼容性参数，强制驱动输出标准ISO格式日期，绕开二进制传值的兼容问题：
  连接串追加ConvNumeric=1;DateFormat=ISO配置，示例如下：

  import pyodbc
  # 替换为你自己的服务器、库、账号密码配置
  conn_str = "DRIVER={HFSQL ODBC Driver};SERVER=你的服务器地址;PORT=4900;DATABASE=你的数据库名;UID=你的账号;PWD=你的密码;ConvNumeric=1;DateFormat=ISO"
  db = pyodbc.connect(conn_str)
  

  配置完成后原有代码不需要修改，fetchone()、pandas.read_sql()都可以正常读取日期值，自动解析为正确的日期类型，不需要额外配置parse_dates参数。
• 如果修改连接串后仍有异常，直接在SQL层面将日期字段转为定长字符串输出，绕开ODBC层的自动类型转换逻辑：
  将查询语句修改为如下形式：

  SELECT CAST(DeliveryDate AS VARCHAR(10)) AS DeliveryDate FROM Orders WHERE Finished = 0
  

  读取出的字符串为DD-MM-YYYY格式的标准日期文本，无论是手动用datetime.strptime(value, "%d-%m-%Y")转换，还是在pandas.read_sql中指定精确解析格式parse_dates={'DeliveryDate': {'format': '%d-%m-%Y'}}，都可以正常处理，无明显性能损失。
• 额外注意：请升级pyodbc到4.0.35及以上正式版本，旧版本pyodbc对非微软系ODBC驱动返回的变长日期值处理存在已知bug，会误判字段末尾的空填充位为有效内容；不建议使用pypyodbc连接HFSQL，该库的类型解析兼容度远低于官方维护的pyodbc。

注意：仅配置dayfirst=True无法解决该问题，这个参数是模糊解析规则，遇到驱动返回的带空填充位的异常值时，依然会走底层整数解析逻辑抛出相同错误。

内容的提问来源于stack exchange，提问作者WvdL1995