ACFの日付で投稿を絞り込む方法
｜WP_Queryのmeta_query

今日以降のイベントを近い順に表示する

Date Pickerで入力したイベント日を使い、今日以降だけを近い順に表示します。例では投稿タイプをevent、フィールド名をevent_dateとします。

コードはイベント一覧を出したいテンプレートへ置き、eventとevent_dateを自分の投稿タイプ名とフィールド名へ置き換えます。例は今日以降を昇順で取得しますが、必要に応じて期間や並びの向きを変えてください。

最初に確認するのは保存形式

日付も投稿メタとして扱うため、先にmeta_queryの基本を押さえておくと、このあとのkey、value、compare、typeの役割を追いやすくなります。値が合っているのに0件になる場合は、meta_queryの確認手順へ進んでください。

Date Pickerの表示形式は入力画面、戻り値の形式はACF関数で取得した時の形です。データベースにはYmd、つまりYYYYMMDDで保存されます。管理画面に2026/06/14と見えていても、WP_Queryでは20260614と比較します。

この記事のYmd例はDate Picker向けです。時刻も保存するDate Time Pickerにはそのまま流用せず、フィールドタイプと保存値を確認してください。

今日以降のイベントだけを取得する最小例

WordPressのタイムゾーンに合わせた今日の日付をcurrent_time( ‘Ymd’ )で作り、meta_queryの比較値にします。まずは10件だけ返す最小条件で確認してください。

$today = current_time( 'Ymd' ); $args = [   'post_type'      => 'event',   'post_status'    => 'publish',   'posts_per_page' => 10,   'meta_key'       => 'event_date',   'orderby'        => [      'meta_value_num' => 'ASC',      'ID'             => 'ASC',   ],   'meta_query'     => [      [         'key'     => 'event_date',         'value'   => $today,         'compare' => '>=',         'type'    => 'NUMERIC',      ],   ],]; $event_query = new WP_Query( $args ); if ( $event_query->have_posts() ) {   echo '<ul>';    while ( $event_query->have_posts() ) {      $event_query->the_post();       printf(         '<li><a href="%1$s">%2$s</a></li>',         esc_url( get_permalink() ),         esc_html( get_the_title() )      );   }    echo '</ul>';} else {   echo '<p>今日以降のイベントはありません。</p>';} wp_reset_postdata();

meta_queryは取得条件、meta_keyとorderbyは並び順です。YmdをNUMERICで比較し、同じ日付ではIDの小さい順にして結果を再現しやすくしています。表示はタイトルとリンクだけにして、条件が合ってから日付や抜粋を足します。

期間で絞り込む場合はBETWEENを使う

期間で絞る場合はcompare => ‘BETWEEN’を使い、開始日と終了日をYmdの配列で渡します。

指定期間内のイベントだけを取得するコード

次のコードは、2026年6月1日から2026年6月30日までのイベントだけを取得する例です。固定の日付で説明していますが、実務ではフォーム入力や現在月から開始日・終了日を作ることもあります。

$start_date = '20260601';$end_date   = '20260630'; $args = [   'post_type'      => 'event',   'post_status'    => 'publish',   'posts_per_page' => 10,   'meta_key'       => 'event_date',   'orderby'        => 'meta_value_num',   'order'          => 'ASC',   'meta_query'     => [      [         'key'     => 'event_date',         'value'   => [ $start_date, $end_date ],         'compare' => 'BETWEEN',         'type'    => 'NUMERIC',      ],   ],]; $event_query = new WP_Query( $args );

BETWEENは開始日と終了日の両方を含みます。境界日を含めない要件なら、>と<の2条件に分けます。

WP_Meta_Queryの公式リファレンスでは、type に DATE を使う場合、BETWEEN は YYYY-MM-DD 形式で保存・比較されている場合に機能する旨が説明されています。ACF Date Pickerの保存値は基本的に Ymd なので、この記事の例では DATE ではなく、Ymd に合わせた NUMERIC 比較として整理しています。

コードはどこに置くか

一覧の表示コードは固定ページや一覧のテンプレートへ置きます。functions.phpへHTML出力まで直接書かず、関数やフックと表示を分けます。

実務では、まず posts_per_page を少なめにして確認するのがおすすめです。いきなり全件取得したり、複数の meta_query を組み合わせたりすると、問題が起きた時に原因を見つけにくくなります。

うまく絞り込めない時に見るポイント

多い原因は、フィールド名、日付形式、投稿タイプの違いと、絞り込み・並び順の混同です。戻り値をY-m-dにしても、Date Pickerのデータベース保存値はYmdです。

もうひとつ注意したいのは、日付フィールドが未入力の投稿です。未入力の投稿を含めたいのか、除外したいのかで条件は変わります。この記事の最小例では、event_date が今日以降の投稿だけを対象にしているため、日付が入っていない投稿は基本的に一覧には出さない前提です。

空文字やYmd以外の値が混在すると、数値比較の結果を信頼できません。対象投稿を1件に絞り、get_post_meta( $post_id, ‘event_date’, true )で保存値を確認してください。

公式資料で確認したいポイント

meta_query、compare、typeはWordPress側、Date Pickerの表示・戻り値・保存形式はACF側の公式資料で確認します。