如何实现IQueryable的DateTimeRange日期范围过滤扩展方法

核心要求是保证过滤逻辑翻译为SQL在数据库执行，必须通过动态拼接表达式树实现，不能引入内存计算逻辑，完整实现如下：

扩展方法代码 #

using System.Linq.Expressions;

public static class QueryableExtensions
{
    public static IQueryable<TSource> DateTimeRange<TSource>(
        this IQueryable<TSource> source, 
        Expression<Func<TSource, DateTime>> keySelector, 
        DateTime? start, 
        DateTime? end)
    {
        if (source == null)
            throw new ArgumentNullException(nameof(source));
        if (keySelector == null)
            throw new ArgumentNullException(nameof(keySelector));

        // 无过滤参数时直接返回原查询
        if (!start.HasValue && !end.HasValue)
            return source;

        // 复用传入选择器的参数，对应lambda表达式中的实体参数x
        var entityParam = keySelector.Parameters[0];
        var dateAccessExpr = keySelector.Body;
        Expression? finalPredicate = null;

        // 拼接开始日期条件：日期字段 >= 开始值
        if (start.HasValue)
        {
            var startValueExpr = Expression.Constant(start.Value, typeof(DateTime));
            finalPredicate = Expression.GreaterThanOrEqual(dateAccessExpr, startValueExpr);
        }

        // 拼接结束日期条件：日期字段 <= 结束值
        if (end.HasValue)
        {
            var endValueExpr = Expression.Constant(end.Value, typeof(DateTime));
            var endCondition = Expression.LessThanOrEqual(dateAccessExpr, endValueExpr);
            finalPredicate = finalPredicate == null
                ? endCondition
                : Expression.AndAlso(finalPredicate, endCondition);
        }

        // 组装完整Where谓词
        var whereLambda = Expression.Lambda<Func<TSource, bool>>(finalPredicate!, entityParam);
        return source.Where(whereLambda);
    }
}

实现特性 #

• 全程基于IQueryable的表达式树拼接逻辑实现，没有调用AsEnumerable()、ToList()等提前触发查询的方法，EF Core等ORM可以直接将最终查询翻译为SQL，过滤操作完全在数据库端执行，不会加载全量数据到内存。
• 可选参数逻辑和手写的判断逻辑完全一致：参数为空时不追加对应过滤条件，不会生成无效查询条件。
• 通用型实现，支持任意实体的DateTime类型字段过滤，不需要针对每个实体重复编写判断逻辑。

适配调整说明 #

• 如果需要过滤的日期字段是可空类型DateTime?，仅需修改方法签名中keySelector的类型为Expression<Func<TSource, DateTime?>>，同时将常量表达式的类型同步改为DateTime?即可，其余逻辑无需改动。
• 如果需要忽略时间部分仅按日期匹配，可以在日期访问表达式上追加Date属性访问：dateAccessExpr = Expression.Property(dateAccessExpr, nameof(DateTime.Date))，即可生成类似WHERE CAST(DateField AS DATE) >= @start的SQL逻辑。

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