SpringDataJPAのJPAクエリメソッド「Between」の使い方を完全ガイド！初心者向け解説

1. Betweenとは？｜範囲検索を簡単にする魔法のキーワード

1. Betweenとは？｜範囲検索を簡単にする魔法のキーワード

Spring Data JPAのBetweenは、データベースから「特定の範囲に収まるデータ」だけを抽出したい時に使う非常に便利な機能です。 例えば、オンラインショッピングの注文履歴から「1月1日から1月31日まで」のデータを探したり、テストの結果から「60点から80点の人」を絞り込んだりする際に活躍します。

プログラミング未経験の方でも安心してください。通常、データベースから範囲検索を行うには複雑な命令文（SQL）を書く必要がありますが、Spring Data JPAならメソッド名にBetweenと含めるだけで、システムが自動的に裏側で検索の仕組みを作ってくれます。

以下に、もっともシンプルな「価格の範囲検索」のサンプルコードを紹介します。

// 商品（Product）エンティティの価格（price）で範囲検索をする例
public interface ProductRepository extends JpaRepository<Product, Long> {

    // 「最小価格」から「最大価格」の間にある商品を検索する
    // メソッド名にBetweenを入れるだけでOK！
    List<Product> findByPriceBetween(Integer minPrice, Integer maxPrice);
}

このように、findByフィールド名Betweenというルールに従ってメソッドを書くだけで、日付や数値のフィルタリング機能が手に入ります。 この手軽さが、Java開発でSpring Data JPAが選ばれる大きな理由の一つです。

2. クエリメソッドの基本的な書き方（Betweenの使い方）

2. クエリメソッドの基本的な書き方（Betweenの使い方）

Spring Data JPAの大きな魅力は、メソッド名を作るだけで自動的にデータベース検索の仕組み（SQL）が作られる「クエリメソッド」という機能です。 特定の期間内にあるデータを抽出したいときは、メソッド名に Between というキーワードを含めるだけで、複雑なプログラムを書く必要がなくなります。

public interface EventRepository extends JpaRepository<Event, Long> {
    // startDate（開始日）が、引数の「開始」と「終了」の間に収まるデータを検索します
    List<Event> findByStartDateBetween(LocalDate start, LocalDate end);
}

例えば、「2026年1月1日から2026年1月31日まで」といった期間を指定して検索したい場合、このメソッドを呼び出す際にその2つの日付を渡すだけで、条件に一致するイベント情報（Event）をリスト形式でまとめて取得できます。

プログラミング未経験の方でも、「どの項目の（startDate）」「範囲を（Between）」検索したいかを英語の文章のように並べるだけなので、非常に直感的でミスが少ない書き方といえます。

3. JPQLでの動作イメージと初心者向けの仕組み解説

3. JPQLでの動作イメージと初心者向けの仕組み解説

Spring Data JPAのクエリメソッドが、内部でどのように動いているかイメージしてみましょう。先ほど作成したメソッドは、Javaが自動的に解析し、次のようなJPQL（Java Persistence Query Language）という「データベース共通の命令文」に変換されます。

SELECT e 
FROM Event e 
WHERE e.startDate BETWEEN ?1 AND ?2

この命令文を、プログラミングが初めての方にも分かりやすく身近な例で例えると、「イベント名簿（Event）の中から、開始日（startDate）が『A月B日（?1）』から『C月D日（?2）』の間にある人だけを探してきて！」と、データベースにお願いしている状態です。

この仕組みのメリットは、以下の3点です。

• 直感的でミスが少ない： 複雑なSQL（データベース専用言語）を自分で書かなくても、Javaのルールに沿って書くだけで安全に検索ができます。
• データの取得が高速： データベースのインデックス（索引）を活用しやすい形式に変換されるため、数万件のデータがあっても一瞬で目的の情報を引き出せます。
• 修正が簡単： 「特定の期間」という条件を「特定の日以降」に変えたい場合も、メソッド名を少し変えるだけで内部のJPQLも自動で最適化されます。

このように、内部で実行されるクエリを意識することで、アプリの動作がより具体的にイメージできるようになり、トラブルの際もどこを確認すべきか判断しやすくなります。

4. 実際の使い方例：初心者でもわかる実装ステップ

4. 実際の使い方例：初心者でもわかる実装ステップ

Spring Data JPAの便利な機能であるfindByStartDateBetweenを、実際にどうやって使うのか見ていきましょう。 プログラミングが初めての方でもイメージしやすいように、「特定の期間に開催されるイベントを探す機能」を例に解説します。

以下のコードは、サービス層（Service）と呼ばれる、アプリケーションの「命令役」となる部分の記述です。

@Service
public class EventService {
    private final EventRepository eventRepository;

    // データベースを操作するための準備（コンストラクタ注入）
    public EventService(EventRepository eventRepository) {
        this.eventRepository = eventRepository;
    }

    /**
     * 指定した開始日と終了日の間にあるイベントをすべて取得する
     * @param startDate 検索したい期間の始まり（例：2026-01-01）
     * @param endDate   検索したい期間の終わり（例：2026-01-31）
     * @return 条件に一致したイベントのリスト
     */
    public List<Event> getEventsWithinDateRange(LocalDate startDate, LocalDate endDate) {
        // リポジトリのメソッドを呼び出すだけで、複雑なSQLを書かずにデータが取得できます
        return eventRepository.findByStartDateBetween(startDate, endDate);
    }
}

このプログラムのポイントは、メソッド名のBetweenというキーワードです。これにより、内部では「startDate以上、かつendDate以下」という範囲検索が自動的に行われます。

例えば、旅行予約サイトで「1月1日から1月10日までに出発するツアーを表示する」といった機能をイメージしてください。引数にその日付を渡すだけで、システムが自動的にデータベースから該当する行を抽出し、List（データの集まり）として返してくれます。 難しい検索条件のロジックを自分で1から書く必要がないため、バグが入りにくく、初心者の方でも直感的に読みやすいコードに仕上がります。

5. Betweenを使うときの注意点

5. Betweenを使うときの注意点

Spring Data JPAのBetweenキーワードは非常に強力ですが、初心者の方が「思っていた結果と違う」とつまずきやすいポイントがいくつかあります。以下の3つの注意点を意識するだけで、バグの少ない安全なコードが書けるようになります。

1. 範囲の「境界値」に注意（端っこは含まれる？）

Betweenで指定した「開始日」と「終了日」は、どちらも検索結果に含まれます。数学の式で表すと 開始日 <= 検索対象 <= 終了日 という形式になります。

2. 日付の「型」と「時間」の落とし穴

Javaのプログラム側で定義している型（LocalDateやLocalDateTime）と、データベース側の設定が一致している必要があります。

// 悪い例：日付だけ(LocalDate)と時間を含む(LocalDateTime)を混ぜると意図しない結果に
public interface UserRepository extends JpaRepository<User, Long> {
    // 誕生日の「日」だけで検索したい場合は、引数もLocalDateに合わせるのが基本です
    List<User> findByBirthDateBetween(LocalDate start, LocalDate end);
}

特に「時間（時・分・秒）」が含まれるデータの場合、終了日を「2026-01-31」と指定すると、内部的に「2026-01-31 00:00:00」と解釈され、31日の日中に起きたデータが含まれないというミスがよく起こります。

3. 大量データを扱う際のパフォーマンス

検索対象のデータが数万件、数十万件と増えてくると、検索スピードが落ちることがあります。これを防ぐためには、データベースのテーブルの対象カラムに「インデックス（Index）」を貼っておくことが重要です。索引を作るようなイメージで、劇的に処理が速くなります。

これらのポイントを押さえておくことで、Spring Data JPAを使ったデータ抽出をより正確に、そしてスムーズに行えるようになります。

6. まとめ

6. まとめ

今回の記事では、SpringDataJPAにおけるBetweenの使い方を学びました。Betweenは、指定した範囲内のデータを検索するために非常に便利な機能で、特に日付や数値の範囲指定に役立ちます。 findByStartDateBetweenを使用することで、簡単に特定の条件に基づくデータを効率的に取得できます。

また、JPQLのスニペットを通して、実際にどのようにSQLクエリに変換されるのかを理解しました。この知識は、パフォーマンスを考慮したクエリ設計やデバッグにも役立ちます。

以下に、別の実用的な例を示します。

public interface OrderRepository extends JpaRepository<Order, Long> {
    List<Order> findByTotalAmountBetween(BigDecimal minAmount, BigDecimal maxAmount);
}

この例では、注文金額の範囲を指定してデータを検索しています。金額や範囲指定を行うクエリメソッドも多くのビジネスロジックにおいて重要な役割を果たします。

これらのクエリメソッドを適切に使用することで、開発効率を高め、より柔軟で強力な検索機能を持つアプリケーションを構築することができます。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

SpringDataJPAのBetweenとは何ですか？

Betweenは、指定した範囲内のデータを検索するためのクエリメソッドのキーワードです。開始日と終了日など、範囲を指定してデータを取得するのに役立ちます。

findByStartDateBetweenメソッドの基本的な使い方を教えてください。

findByStartDateBetweenメソッドは、開始日と終了日を引数に指定し、その範囲内に該当するデータを取得します。

Betweenを使ったクエリはどのようなSQLに変換されますか？

例えば、「SELECT e FROM Event e WHERE e.startDate BETWEEN ?1 AND ?2」のように変換されます。このクエリは範囲指定されたデータを取得するためのSQLです。

SpringDataJPAのBetweenを使うときに注意すべきことは何ですか？

開始日と終了日の型がエンティティのフィールドと一致していること、範囲の境界値が含まれる点（startDate ≤ 値 ≤ endDate）、大量データではインデックスの活用が重要です。

Betweenを使って日付範囲を検索する具体的な例を教えてください。

findByStartDateBetweenメソッドを作成し、サービス層で日付範囲を引数に指定して呼び出します。これにより、その範囲内のイベントデータを取得できます。

範囲指定が日付型でない場合はどうすればいいですか？

日付型以外の範囲指定も可能です。例えば、数値や金額を対象としたクエリメソッドも作成できます。

Betweenを使用するメリットは何ですか？

範囲指定された条件で効率的にデータを取得できる点です。特に、日付や金額のような範囲検索が必要なシナリオで役立ちます。

インデックスを活用することでどのような効果がありますか？

インデックスを設定すると、データベースの検索速度が向上し、大量データを扱う際のパフォーマンスが改善されます。

Betweenの境界値が含まれるというのは具体的にどういう意味ですか？

Betweenでは、指定した開始値と終了値を含めた範囲でデータを検索します。例えば、2023-01-01と2023-01-31を指定した場合、その両日を含むデータが取得されます。

JPQLでのクエリとSQLでのクエリの違いは何ですか？

JPQLはエンティティを操作するためのクエリ言語で、SQLはデータベースのテーブルを直接操作します。SpringDataJPAでは、JPQLが内部でSQLに変換されて実行されます。