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

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

Date Pickerで入力した開催日を使い、今日以降だけを近い順に表示します。このサンプルでは、開催日を持つ投稿タイプを works、フィールド名を event_date としています。イベント専用の投稿タイプを event として登録したサイトなら、コードの works を event へ置き換えてください。

表示名ではなく投稿タイプの登録キーとACFのフィールド名を使います。入力画面で日付が見えていても、キーが違う投稿タイプを検索していれば対象には入りません。

次のACF実画面では、この記事で使うフィールド名と表示形式、戻り値の形式を同時に確認できます。

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

日付も投稿メタとして扱うため、先に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にはそのまま流用せず、フィールドタイプと保存値を確認してください。

次の投稿編集画面では、入力欄に2026年8月12日が表示されています。画像の下で、この表示と8桁の保存値を分けてコードへ渡します。

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

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

WP Query Builderでは、投稿タイプ「works」、投稿ステータス「publish」、件数「10」、並び順「ASC」、並び替え「meta_value_num」を選び、event_date が 20260801 以上になる数値条件を入力しました。自動最適化をオフにして生成した $args のうち、固定値 20260801 だけを $today へ置き換えています。

PHPテンプレートを使う子テーマの template-parts/event-list.php に次のコードを保存します。表示したい固定ページなどのテンプレートで、メインループの the_post() の後に get_template_part( ‘template-parts/event-list’ ); と呼び出してください。呼び出し先がPHP領域なら <?php を重ねて書く必要はありません。投稿本文や追加CSSへは貼りません。

<?php$today = (int) current_time( 'Ymd' ); $args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'ASC',    'orderby' => 'meta_value_num',    'meta_query' => array(        array(            'key' => 'event_date',            'compare' => '>=',            'type' => 'NUMERIC',            'value' => $today        )    ),    'meta_key' => 'event_date'); $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><br>開催日（保存値）：%3$s</li>',         esc_url( get_permalink() ),         esc_html( get_the_title() ),         esc_html( get_post_meta( get_the_ID(), 'event_date', true ) )      );   }    echo '</ul>';} else {   echo '<p>条件に合うイベントはありません。</p>';} wp_reset_postdata();

meta_query は日付の下限を決めます。meta_key で並べるフィールドを選び、orderby の meta_value_num で数値の昇順にします。Builderが生成するのは $args までで、今日の日付、表示ループ、0件時の文言、リセットは手動で組み合わせています。

この生成コードだけでは、同じ開催日を持つ投稿どうしの順番は固定しません。必要なら、日付順が正しく動くことを確認した後でIDなどの二次ソートを手動追加します。meta_key 自体も、そのキーが保存されている投稿を対象にする点に注意してください。

まずは保存値も一緒に表示して、条件と結果を見比べます。日付を読者向けの表記へ整えるのは、対象と順番が合ってからで構いません。

ACFの入力やPHPを試すときは、本番と分けた環境で表示を確認します。サーバー上に試す場所を用意する場合は、XserverのPHP対応とバックアップ条件も確認できます。

基準日を固定して、対象の2件を見比べる

保存値が 20260712・20260812・20260905 の3件で比べます。画像は最初の $today を 20260801 に置き換えた表示です。7月12日は外れ、8月12日と9月5日が近い順に並びます。実運用では (int) current_time( ‘Ymd’ ) に戻してください。

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

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

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

次は2026年8月12日から9月5日までを対象にする例です。最初のパーツ内にある $today と $args の定義を、次のコードへ置き換えます。$event_query = new WP_Query( $args ); 以降の表示ループとリセットは残してください。別のクエリを下へ足す例ではありません。

$args = array(    'post_type' => 'works',    'post_status' => 'publish',    'posts_per_page' => 10,    'order' => 'ASC',    'orderby' => 'meta_value_num',    'meta_query' => array(        array(            'key' => 'event_date',            'compare' => 'BETWEEN',            'type' => 'NUMERIC',            'value' => array(                20260812,                20260905            )        )    ),    'meta_key' => 'event_date');

この $args も、同じBuilder実画面で比較方法を「BETWEEN」、値を「20260812,20260905」に変えて生成したものです。BETWEENは開始日と終了日の両方を含みます。 境界日を含めない要件なら、>と<の2条件に分けます。

この表は同じ3件に対して、開始日と終了日だけを変えた結果です。フォーム入力から期間を作る場合は、8桁かどうかだけでなく実在する日付か、開始日が終了日以前かも確認します。 未確認の入力をそのまま渡さないでください。

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

保存値と期間の境界が分かったら、WP Query Builderで同じmeta_queryを組み立てられます。今日の日付を動的に作る処理と、取得結果を表示するループはこの記事のパーツで組み合わせます。

コードはどこに置くか

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

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

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

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

もうひとつ注意したいのは、日付フィールドが未入力の投稿です。未入力の投稿を含めたいのか、除外したいのかで条件は変わります。この記事の最小例では、日付が入っていない投稿は一覧に含めません。

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

meta_queryとACF Date Pickerの公式資料

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