特定日期格式下jQGrid服务器端日期筛选功能失效问题

这个问题我之前帮同事排查过类似的，核心原因是日期格式的歧义导致服务器端解析错误——当你用dd-MM-yyyy格式时，日部分小于12的日期（比如05-10-2024）会被服务器默认的日期解析逻辑当成MM-dd-yyyy来处理，把5月10日误认为10月5日，自然筛选不到正确的数据。下面给你几个针对性的解决步骤：

1. 强制服务器端使用指定格式解析日期参数 #

在处理JQGrid筛选请求的后端代码中，不要依赖默认的日期解析，而是显式用dd-MM-yyyy格式来解析筛选参数，避免区域设置带来的歧义。以C#为例：

// 假设从请求中获取JQGrid传递的日期筛选值
string filterDateInput = Request.Form["YourDateColumnFilter"];
DateTime filterDate;

// 用TryParseExact确保严格按照指定格式解析
if (DateTime.TryParseExact(filterDateInput, "dd-MM-yyyy", CultureInfo.InvariantCulture, DateTimeStyles.None, out filterDate))
{
    // 使用解析后的filterDate执行数据库筛选逻辑
}
else
{
    // 处理日期解析失败的异常情况，比如返回空结果或提示错误
}

2. 同步JQGrid前端筛选控件的日期格式 #

确保JQGrid日期列的筛选控件（比如日期选择器）输出的格式和后端解析格式完全一致。在colModel的searchoptions里配置日期选择器的格式：

colModel: [
    {
        name: 'YourDateColumn',
        index: 'YourDateColumn',
        // 你的自定义日期格式化函数
        formatter: function(cellvalue) {
            return FormatNullDateCellValue(cellvalue);
        },
        searchoptions: {
            dataInit: function(element) {
                $(element).datepicker({
                    dateFormat: 'dd-mm-yy' // 这里的格式要和后端保持一致，yy对应四位年份
                });
            },
            // 指定支持的筛选操作符，确保日期筛选逻辑正确
            sopt: ['eq', 'ne', 'lt', 'le', 'gt', 'ge']
        }
    }
]

3. 检查自定义日期格式化函数的输出 #

确认你的FormatNullDateCellValue函数返回的是标准的dd-MM-yyyy格式字符串，没有多余的空格或异常字符。比如可以优化函数逻辑：

function FormatNullDateCellValue(cellValue) {
    // 处理空值或无效日期的情况
    if (!cellValue || cellValue === 'null' || cellValue.trim() === '') {
        return '';
    }
    
    // 将输入转换为Date对象，确保正确解析
    const date = new Date(cellValue);
    // 补零确保两位格式
    const day = String(date.getDate()).padStart(2, '0');
    const month = String(date.getMonth() + 1).padStart(2, '0'); // 月份从0开始，要+1
    const year = date.getFullYear();
    
    return `${day}-${month}-${year}`;
}

4. 手动拦截筛选请求，修正日期格式（可选） #

如果上面的配置还是有问题，可以在JQGrid的beforeSearch事件中手动处理筛选参数，确保传递给服务器的是正确格式的日期：

$("#yourGridId").jqGrid({
    // 其他网格配置
    beforeSearch: function() {
        const postData = $(this).jqGrid('getGridParam', 'postData');
        if (postData.filters) {
            let filters = JSON.parse(postData.filters);
            // 遍历所有筛选规则，找到日期列并修正格式
            filters.rules.forEach(rule => {
                if (rule.field === 'YourDateColumn') {
                    const date = new Date(rule.data);
                    const day = String(date.getDate()).padStart(2, '0');
                    const month = String(date.getMonth() + 1).padStart(2, '0');
                    const year = date.getFullYear();
                    rule.data = `${day}-${month}-${year}`;
                }
            });
            // 更新筛选参数
            postData.filters = JSON.stringify(filters);
            $(this).jqGrid('setGridParam', { postData: postData });
        }
        return true;
    }
});

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