如何仅用WP_Query模拟SELECT YEAR(post_date)的SQL查询？

要实现你需要的按发布年份分组并倒序获取的需求，可以通过WP_Query的钩子修改SQL子句来完成，无需直接使用$wpdb。以下是具体实现步骤：

核心思路 #

WP_Query本身默认不会返回仅包含年份的分组结果，但可以通过posts_clauses过滤器直接修改查询的SELECT、GROUP BY和ORDER BY子句，匹配你目标SQL的逻辑。

完整代码示例 #

// 定义修改查询子句的函数
function custom_year_group_clauses( $clauses, $query ) {
    // 仅对标记了自定义参数的查询生效，避免干扰其他查询
    if ( isset( $query->query_vars['fetch_post_years'] ) && $query->query_vars['fetch_post_years'] ) {
        // 替换SELECT字段为提取年份
        $clauses['fields'] = "YEAR(post_date) AS post_year";
        // 设置分组规则
        $clauses['groupby'] = "YEAR(post_date)";
        // 设置倒序排序
        $clauses['orderby'] = "YEAR(post_date) DESC";
    }
    return $clauses;
}
add_filter( 'posts_clauses', 'custom_year_group_clauses', 10, 2 );

// 构建WP_Query参数
$year_query_args = array(
    'post_status' => 'publish',
    'posts_per_page' => -1, // 获取所有分组结果
    'fetch_post_years' => true, // 自定义标记，触发过滤器
);

$year_query = new WP_Query( $year_query_args );

// 提取年份结果
$published_years = array();
if ( $year_query->have_posts() ) {
    while ( $year_query->have_posts() ) {
        $year_query->the_post();
        $published_years[] = get_post()->post_year;
    }
}

// 重置查询状态，恢复全局post变量
wp_reset_postdata();

// 移除过滤器，防止影响后续查询
remove_filter( 'posts_clauses', 'custom_year_group_clauses', 10, 2 );

代码说明 #

1. 自定义标记参数：fetch_post_years用于识别当前查询是否需要修改，避免过滤器影响站点内其他WP_Query操作。
2. posts_clauses过滤器：直接修改查询的核心子句，完全匹配你目标SQL的逻辑：
   • fields子句替换为提取post_date的年份，并别名post_year
   • groupby按年份分组
   • orderby按年份倒序排列
3. 结果提取：遍历查询结果时，通过get_post()->post_year获取分组后的年份值。
4. 清理操作：查询结束后重置post数据并移除过滤器，保证后续查询不受影响。

为什么parse_query无效？ #

parse_query钩子主要用于解析查询变量（比如将参数转换为WP_Query能识别的格式），无法直接修改最终生成的SQL语句，因此需要使用posts_clauses这类直接操作SQL子句的钩子。

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