$gte (Maior Que ou Igual)
Última atualização: 2026-10-09
$gte (Maior Que ou Igual)
$gte é a comparação maior-que-ou-igual em forma de expressão. Ela recebe dois argumentos e retorna true quando o primeiro é maior ou igual ao segundo. É usado para verificações de limiar e filtragem por intervalo, como manter produtos cujas vendas atingem um mínimo garantido. A sintaxe de expressão é { $gte: [expr1, expr2] }, diferente do operador de consulta { field: { $gte: value } }. As comparações seguem a ordem de tipos BSON e, diferente de $gt, retorna true quando os valores são iguais.
| Categoria | Conjunto, Condição e Conversão |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $gte: [ <expressão1>, <expressão2> ] }⚙️ Parâmetros
| expressão 1 | A primeira expressão a comparar. |
|---|---|
| expressão 2 | A segunda expressão a comparar. |
Retorno：true quando o primeiro é maior ou igual ao segundo, caso contrário false
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $gte: verificar se as vendas atingem a meta
db.products.aggregate([
{ $project: {
qualified: { $gte: ['$sales', '$target'] }
} }
])Saída：
{ '_id': 1, 'qualified': true }
{ '_id': 2, 'qualified': false }📌 Notas
- Igualdade também retorna true, a diferença chave em relação a $gt
- As formas de expressão e de consulta são escritas de modo diferente
- Comparações seguem a ordem de tipos BSON
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre $gte e $gt?
A$gte inclui igualdade, enquanto $gt é estritamente maior.
QO $gte consegue comparar datas?
ASim, datas comparam pela ordem cronológica.
QOs dois argumentos de $gte precisam ser números?
ANão — quaisquer tipos comparam pela ordem de tipos BSON.
