Como Usar Between Entre Duas Colunas de Data no Laravel

Trabalhar com intervalos de datas é uma necessidade comum em aplicações web, especialmente em sistemas que lidam com eventos, agendamentos ou relatórios. Neste artigo, vamos explorar como usar o operador BETWEEN entre duas colunas de data no Laravel, tanto com o Eloquent quanto com o Query Builder.

O Problema

SELECT *
FROM eventos
WHERE '2024-11-10' BETWEEN data_inicio AND data_fim;

No Laravel, podemos traduzir essa lógica de forma eficiente usando os recursos do framework.

Usando o Eloquent

Explicação:

• whereBetween() é usado para especificar o intervalo de comparação.
• Passamos a data a ser consultada como primeiro parâmetro.
• As colunas data_inicio e data_fim delimitam o intervalo.

Usando o Query Builder

Exemplo:

use Illuminate\Support\Facades\DB;

$dataConsulta = '2024-11-10';

$eventos = DB::table('eventos')
->whereRaw('? BETWEEN data_inicio AND data_fim', [$dataConsulta])
->get();

Explicação:

• whereRaw permite inserir expressões SQL personalizadas.
• O uso de ? e do array [$dataConsulta] protege contra SQL Injection.

Exemplos Adicionais

Consulta para verificar se data_fim está entre data_inicio e outra coluna, como data_limite:

$eventos = DB::table('eventos')
->whereRaw('data_fim BETWEEN data_inicio AND data_limite')
->get();

Usando Operadores para maior controle

$dataConsulta = '2024-11-10';

$eventos = Evento::where('data_inicio', '<=', $dataConsulta)
    ->where('data_fim', '>=', $dataConsulta)
    ->get();

Consultar dados usando BETWEEN entre colunas é uma tarefa simples no Laravel, tanto com o Eloquent quanto com o Query Builder. O uso de whereRaw oferece a flexibilidade necessária para comparações entre colunas, enquanto operadores como >= e <= tornam sua consulta mais legível e direta.