WP_Query パラメーターbefore

before は、日付条件の終了地点を指定するために使います。たとえば「2026年12月31日以前に公開された投稿だけを出したい」「指定日より前に更新された投稿を確認したい」といった場面で使います。

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

before は何を指定する項目か

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

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

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

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

after、before、inclusive の関係

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

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

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

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

Builder での扱い

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

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

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

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

公開日や更新日の上限を設け、指定日より前の投稿だけに取得範囲を絞りたい時に使います。

予約日や独自の開催日を絞る場合、または表示順だけを逆にしたい場合は before の役割ではありません。

日付だけを書くと時刻境界の解釈で最終日の投稿が外れることがあるため、終了日を含める要件と inclusive を一緒に確認します。

「3月31日まで」と「3月31日より前」は結果が変わるため、終了日の言い方をそのまま条件へ写します。

終了日の0時・日中・翌日にテスト投稿を用意し、取得できた投稿IDと投稿日時を並べて、期待する最終日まで含まれるか確認します。

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

終了日を入れて投稿が消えた時は、日付形式、対象カラム、ほかの条件を一つずつ外す手順が役立ちます。

記事を読む →

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

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

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

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

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