WinForm DateTimePicker传日期到SQL Server转换失败解决方法

你遇到的字符串转日期失败异常，核心原因是把DateTime值转成字符串传参的设计本身存在缺陷：

• SQL Server解析日期字符串时，会优先使用服务端配置的区域语言、默认日期格式规则做匹配，你格式化用的/在SQL Server日期语法中是区域分隔符占位符，如果服务端配置的日期分隔符不是/（比如部分欧洲区域用.做分隔符），或者默认日期格式优先级不匹配yyyy/MM/dd的顺序，就会直接抛出转换失败错误。
• 本地开发环境因为区域设置和你格式化的规则匹配所以暂时没暴露问题，但只要部署环境换区域配置就会复现，属于不稳定的实现。

永远不要把日期转成字符串传给SQL Server，直接使用类型化参数传递DateTime值，这是根治这类问题的唯一通用方案：

1. 首先修改Table Adapter中GetAvailableRooms方法的参数定义，把两个入参的类型从string改为DateTime，和数据库表中DATE类型的字段对应。
2. 去掉后台代码中所有日期转字符串的逻辑，直接传递DateTimePicker控件的日期值，使用.Date属性截断时间部分，精准匹配数据库的DATE类型：

private void btn_searchRooms_Click(object sender, EventArgs e)
{
    DateTime checkIn = dtPicker_checkIn.Value.Date;
    DateTime checkOut = dtPicker_checkOut.Value.Date;

    var dt = roomsTableAdapter.GetAvailableRooms(checkIn, checkOut);
    dtGridView_availableRooms.DataSource = dt;
}

这种实现走ADO.NET原生的类型化参数传值，会直接把.NET的DateTime类型映射为SQL Server的日期类型，完全绕开字符串解析环节，不会受任何服务端区域配置影响，同时也能避免SQL注入风险。

如果因为历史配置原因暂时无法修改Table Adapter的参数类型，必须传递字符串参数，可按以下规则处理：

• 优先使用SQL Server全局无歧义的日期字符串格式：不带任何分隔符的yyyyMMdd格式，这个格式在任何区域、任何语言配置下的SQL Server实例中都能被正确解析为日期，不会触发转换错误，对应格式化代码为dtPicker_checkIn.Value.ToString("yyyyMMdd")
• 如果必须保留yyyy/MM/dd的带分隔符格式，需要在Table Adapter的SQL查询语句中显式指定日期转换的格式码，强制SQL Server按照指定格式解析字符串，不要依赖默认解析规则。yyyy/MM/dd对应的SQL转换格式码为111，查询写法示例：

SELECT * FROM Rooms
WHERE RoomId NOT IN (
    SELECT RoomId FROM Bookings
    WHERE CheckIn < CONVERT(DATE, @checkOut, 111)
    AND CheckOut > CONVERT(DATE, @checkIn, 111)
)

• 所有数据库日期类型字段对应的传参，必须使用DateTime类型的参数，不要为了省事定义为字符串类型
• 不要假设数据库服务端的区域配置和本地开发环境一致，任何依赖默认格式解析的日期传参都有概率在部署后报错
• 禁止使用除yyyyMMdd、yyyy-MM-ddTHH:mm:ss之外的自定义日期字符串格式传参，其他格式都存在区域兼容风险

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