能否通过meta_query自定义查询实现促销活动日期筛选？

算力阿峰

2026-8-9

问题

我创建了名为promotions的自定义文章类型，在每个促销文章的元数据中存储了promo_start_date和promo_end_date两个字段。需求是前端仅显示满足以下条件的促销活动：

current_date >= promo_start_date AND current_date <= promo_end_date

例如，若某促销的promo_start_date为2022-12-18，promo_end_date为2023-01-08，则仅在该时间段内于前端展示。

我想知道能否通过meta_query实现此功能，尝试了以下代码：

$args = [
    'paged' => 1,
    'post_type' => 'promotions',
    'posts_per_page' => 15,
    'meta_query' => [
        [
            'key' => 'promo_start_date',
            'value' => gmdate('Y-m-d'),
            'type' => 'DATE',
            'compare' => '>=',
        ],
        [
            'key' => 'promo_end_date',
            'value' => gmdate('Y-m-d'),
            'type' => 'DATE',
            'compare' => '<=',
        ],
    ],
];

我可以用原生sql实现，但现在需要通过Search and Filter插件的过滤器来修改查询参数，尝试了如下代码：

function me_sf_edit_query_args($query_args, $sfid) {
    // if search form has specified ID, change query args
    if ($sfid == 11000) {
        $query_args['meta_query'] = [
            [
                'key' => 'promo_start_date',
                'value' => gmdate('Y-m-d'),
                'type' => 'DATE',
                'compare' => '>=',
            ],
            [
                'key' => 'promo_end_date',
                'value' => gmdate('Y-m-d'),
                'type' => 'DATE',
                'compare' => '<=',
            ],
        ];
    }

    return $query_args;
}
add_filter('sf_edit_query_args', 'me_sf_edit_query_args', 20, 2);

请问此方案是否可行？

解答

这个方案完全可行，但需要注意几个关键细节：

meta_query逻辑匹配需求
WordPress的meta_query默认以AND逻辑连接多个条件，正好契合你需要的「当前日期在促销起止区间内」的判断逻辑，所以条件组合是正确的。
日期时区与格式一致性

你用gmdate('Y-m-d')获取UTC日期，要确保后台存储的promo_start_date和promo_end_date也是UTC时区的YYYY-MM-DD格式，否则会出现时区偏差导致的展示错误。如果后台是按本地时区存储的日期，建议改用date('Y-m-d')来匹配。
type => 'DATE'参数会让WordPress按日期类型比较，而非字符串比较，能避免字符串顺序带来的逻辑错误（比如2023-01-08和2023-12-01的字符串比较问题）。

Search and Filter插件的兼容性优化

sf_edit_query_args是插件官方提供的修改查询参数的钩子，优先级设为20合理（确保在插件默认逻辑之后生效），只要表单ID11000正确，代码就能正常运行。

如果插件本身已经添加了其他meta_query条件，直接覆盖$query_args['meta_query']会丢失原有规则。这种情况下，应该合并条件而非覆盖：

function me_sf_edit_query_args($query_args, $sfid) {
    if ($sfid == 11000) {
        // 初始化meta_query数组（如果不存在）
        if (!isset($query_args['meta_query'])) {
            $query_args['meta_query'] = [];
        }
        // 明确逻辑关系（默认是AND，可省略）
        $query_args['meta_query']['relation'] = 'AND';
        // 添加日期过滤条件
        $query_args['meta_query'][] = [
            'key' => 'promo_start_date',
            'value' => gmdate('Y-m-d'),
            'type' => 'DATE',
            'compare' => '>=',
        ];
        $query_args['meta_query'][] = [
            'key' => 'promo_end_date',
            'value' => gmdate('Y-m-d'),
            'type' => 'DATE',
            'compare' => '<=',
        ];
    }
    return $query_args;
}
add_filter('sf_edit_query_args', 'me_sf_edit_query_args', 20, 2);

性能优化建议
如果促销文章数量较多，建议为promo_start_date和promo_end_date这两个元字段添加数据库索引，能大幅提升查询速度。可以通过自定义迁移脚本或者Meta Box等插件的索引功能实现。

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

能否通过meta_query自定义查询实现促销活动日期筛选？

问题 #

解答 #

问题

解答