如何在Yii框架WHERE条件中调用自定义函数筛选逾期付款记录

你当前的写法无法生效，因为dateDiff是PHP端的函数，调用时传入的'due_date'会被当作普通字符串处理，而不是数据库表的字段——PHP函数无法直接操作数据库列，必须把日期差的计算逻辑放到SQL层面执行。

下面给出两种可行方案：

方案一：直接使用Yii数据库表达式（Expression） #

直接在where条件中写入SQL的日期差计算逻辑，让数据库完成每条记录的逾期判断：

$now = Yii::$app->jdate->date('Y/m/d');

$query = ProductUserPayement::find()
    ->where(new \yii\db\Expression(
        'DATEDIFF(STR_TO_DATE(:now, "%Y/%m/%d"), STR_TO_DATE(due_date, "%Y/%m/%d")) <= 1',
        [':now' => $now]
    ));

说明： #

• STR_TO_DATE用于将波斯历字符串转换为数据库可识别的日期类型，确保计算准确；
• DATEDIFF是MySQL的日期差函数，若使用其他数据库（如PostgreSQL），需替换为对应函数（比如PostgreSQL用DATE_PART('day', :now::date - due_date::date)）；
• 若数据库时区不是Asia/Tehran，可在SQL中加入时区转换，确保日期计算的一致性。

方案二：封装SQL表达式的自定义静态方法 #

把日期差的SQL逻辑封装到模型的静态方法中，复用性更好：

首先修改模型类，新增一个返回SQL表达式的方法：

public static function dateDiffSql($date1, $dateColumn) {
    // $date1：PHP端的当前日期字符串（波斯历）
    // $dateColumn：数据库表的日期字段名
    return new \yii\db\Expression(
        'DATEDIFF(STR_TO_DATE(:date1, "%Y/%m/%d"), STR_TO_DATE(' . $dateColumn . ', "%Y/%m/%d"))',
        [':date1' => $date1]
    );
}

然后在查询中调用这个方法：

$now = Yii::$app->jdate->date('Y/m/d');

$query = ProductUserPayement::find()
    ->where(['<=', self::dateDiffSql($now, 'due_date'), 1]);

关键注意点 #

• 必须区分应用层计算和数据库层计算：你的原dateDiff函数适合计算单个已知日期的差值，但要筛选数据库所有记录，必须让数据库执行每条记录的字段计算；
• 波斯历的日期解析需确保数据库函数支持，若存储的是公历日期，需调整转换逻辑匹配存储格式。

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