WP_Query パラメーターafter

after は、日付条件の開始地点を指定するために使います。たとえば「2026年1月1日以降に公開された投稿だけを出したい」「先月以降に更新された投稿だけを出したい」といった場面で使います。

ただし、after が扱うのは、基本的に WP_Query の date_query が見る WordPress 標準の日付です。イベント開催日や発売日など、カスタムフィールドに保存した日付で絞り込む場合は、meta_query 側の条件を検討します。

after は何を指定する項目か

after は、date_query の中で「この日付より後」を指定する項目です。開始日を決める項目と考えると分かりやすくなります。

たとえば after => ‘2026-01-01’ と書くと、2026年1月1日より後の投稿を対象にする意図になります。開始日を含めたい場合は、inclusive の指定も合わせて確認します。

ここで大事なのは、after は「開始日」だけを担当することです。終了日も指定したい場合は before を使い、開始日そのものを含めるかどうかは inclusive で考えます。

after だけを指定すると、開始日以降の範囲になります。期間を明確にしたい場合は、before と組み合わせて開始日と終了日の両方を指定します。

after、before、inclusive の関係

after は開始日、before は終了日、inclusive は境界の日付を含めるかどうかを指定します。この3つを分けて理解すると、日付範囲の指定が読みやすくなります。

期間で絞り込みたい場合は、after と before を組み合わせます。さらに開始日と終了日を含めたい場合は、inclusive => true を指定します。

inclusive を忘れると、開始日や終了日の投稿が含まれないように見えることがあります。期間の境界を含めたいのかどうかは、記事一覧の要件として先に決めます。

たとえば「2026年1月1日以降」と説明するなら、通常は1月1日を含めたいはずです。このような時は、inclusive => true を確認します。

Builder での扱い

WP Query Builder では、after は date_query の開始日入力として扱う想定です。初心者向けには、after という英語だけを見せるより、「開始日」「この日以降」のように表示すると分かりやすくなります。

Builder では、「見る日付: 投稿日」「開始日: 2026-01-01」「開始日を含める: はい」のように分けて入力させ、内部で after と inclusive に変換する流れが自然です。

終了日も必要な場合は、before の入力欄も用意します。さらに、投稿日を見るのか更新日を見るのかを選べるようにすると、column の指定も自然に扱えます。

使いどころ・避けどころと実践確認

投稿日や更新日の下限を決め、指定日より後の投稿だけを候補にしたい時に使います。

イベント日などカスタムフィールド内の日付を比べる場合や、単に新しい順へ並べたいだけの場合は使いません。

境界日を含む要件なのに inclusive を省くと、開始日の投稿だけが欠けて見えるため、仕様文の「以降」が境界を含むか先に決めます。

画面で「2026年1月1日以降」と案内するなら、1月1日を含む設定までそろって初めて文言どおりになります。

境界日の前日・当日・翌日に1件ずつテスト投稿を置き、inclusive の有無で取得できた投稿IDがどう変わるかを記録します。

実践記事で確認WP_Queryで投稿が表示されない時に見るチェックリスト

日付条件を足した直後に0件になった場合は、ほかの絞り込みを外す順番まで含めて切り分けられます。

記事を読む →

WordPressの仕様で確認するポイント

公式資料では、WP_Query の Date Parameters と WP_Date_Query のリファレンスで、after、before、inclusive、column などの構造を確認できます。

after は単独ではなく、date_query の配列の中で使う項目です。公式資料を見る時も、date_query 全体の構造として確認すると理解しやすくなります。

after は、date_query の中で開始日を指定する項目です。指定日より後の投稿を取得したい時に使い、指定日も含めたい場合は inclusive を確認します。

迷った時は、after だけを使った最小構成で確認します。取得できることを確認してから、before、column、他の絞り込み条件へ広げると安全です。