如何在EF Core中映射MySQL内置函数TIMESTAMPDIFF并避免参数加引号？

问题出在你用了string类型作为单位参数，哪怕加了[NotParameterized]，EF Core还是会把它当成字符串常量处理，自动加上单引号。要让单位变成无引号的SQL关键字，有两种靠谱的解决方法：

方法一：用枚举替代字符串参数（推荐） #

这种方式类型更安全，也能让EF直接生成无引号的单位：

1. 先定义枚举，包含你需要的时间单位：

public enum DateDiffUnit
{
    SECOND,
    MINUTE,
    HOUR,
    DAY,
    MONTH,
    YEAR
}

2. 修改DbFunction的定义，把unit参数换成这个枚举：

[DbFunction("TIMESTAMPDIFF", IsBuiltIn = true)]
public static int DateDiff(DateDiffUnit unit, DateTime start, DateTime end)
{
    throw new InvalidOperationException("该方法仅用于EF Core生成SQL，不能直接调用");
}

3. 在你的DbContext的OnModelCreating方法里，配置这个函数的参数为字面量翻译：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    modelBuilder.HasDbFunction(typeof(YourDbContext).GetMethod(nameof(DateDiff)))
        .HasParameter("unit")
        .HasLiteralTranslation();
}

调用的时候直接传枚举值就行，比如：

var result = dbContext.YourEntities
    .Select(e => DateDiff(DateDiffUnit.MONTH, e.StartDate, e.EndDate))
    .ToList();

生成的SQL里就会是TIMESTAMPDIFF(MONTH, ...)，完全不带引号。

方法二：手动配置字符串参数的翻译（兼容原有string参数） #

如果你坚持要用string类型的单位参数，可以在模型配置里手动处理参数的翻译逻辑：

1. 先保留你原来的DbFunction定义，但去掉[NotParameterized]（这个特性不解决字符串加引号的问题）：

[DbFunction("TIMESTAMPDIFF", IsBuiltIn = true)]
public static int DateDiffMinute(string unit, DateTime start, DateTime end)
{
    throw new Exception("Should not be called!");
}

2. 在DbContext的OnModelCreating里，给这个函数的unit参数添加自定义翻译：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    var dateDiffFunc = modelBuilder.HasDbFunction(typeof(YourDbContext).GetMethod(nameof(DateDiffMinute)));
    
    dateDiffFunc.HasParameter("unit")
        .HasTranslation(unitExpr => 
        {
            // 只处理常量字符串的情况，确保单位是固定值
            if (unitExpr is ConstantExpression constant && constant.Value is string unitValue)
            {
                // 直接返回SQL字面量，不带引号
                return new SqlLiteralExpression(unitValue);
            }
            // 如果不是常量字符串，抛出异常（避免运行时出错）
            throw new InvalidOperationException("单位参数必须是常量字符串");
        });
}

这样当你传入常量字符串"MONTH"时，EF会生成无引号的MONTH。

为什么原来的[NotParameterized]没用？ #

[NotParameterized]只是告诉EF不要把参数转换成SQL参数（比如@p0），但对于string类型的常量，EF依然会把它当成字符串字面量处理，自动加上单引号。我们需要的是把单位识别成SQL的关键字/标识符，而不是字符串，所以必须用字面量翻译或者枚举映射的方式。

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