$gte (Maior Que ou Igual)
Última atualização: 2026-10-09
$gte (Maior Que ou Igual)
$gte seleciona documentos onde o valor de um campo é maior ou igual ao valor especificado. `{ age: { $gte: 21 } }` corresponde a usuários com 21 anos ou mais. É a contraparte inclusiva de $gt, usada para semânticas de mínimo: faixas de idade, estoque mínimo, janelas de tempo. Combine com $lte para um intervalo fechado.
| Categoria | Comparação |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ <campo>: { $gte: <valor> } }⚙️ Parâmetros
| campo | O campo do documento a corresponder; caminhos com ponto acessam campos aninhados. |
|---|---|
| valor | O valor do limite inferior; o próprio limite é incluído. |
Retorno：Cursor dos documentos correspondentes
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $gte: usuários com 18 anos ou mais
// Idade exatamente 18 é incluída
db.users.find({ age: { $gte: 18 } })
// Intervalo fechado: idades de 18 a 30
db.users.find({ age: { $gte: 18, $lte: 30 } })Saída：
// Retorna usuários com age de pelo menos 18, além daqueles no intervalo fechado 18-30📌 Notas
- $gte inclui a fronteira; essa é a única diferença em relação a $gt
- Números, strings e datas são todos comparáveis, mas tipos incompatíveis nunca correspondem
- Se você inverter os limites com $lte (ex.: $gte: 30, $lte: 18), nada corresponderá
🏷️ Tags Relacionados
💡 Casos Relacionados
Noções básicas sobre consultas a documentos: o método `find` e as projeções
Operadores de consulta: um guia completo com mais de 30 operadores
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual tem melhor desempenho, $gte ou $gt?
ADesempenho idêntico, ambos podem usar índices. Escolha com base em se a fronteira deve ser incluída.
QComo consulto produtos com pelo menos 10 em estoque?
AUse $gte como piso: { stock: { $gte: 10 } }.
Q$gte corresponde a null?
ANão. null não é comparado com números, então $gte só corresponde a valores comparáveis do mesmo tipo.
