MongoDB $gte

Summary: in this tutorial, you will learn how to use the MongoDB $gte operator to select documents where the value of a field is greater than or equal to a specified value.

Introduction to the MongoDB $gte operator

The $gte is a comparison query operator that allows you to select documents where a value of a field is greater than or equal to ( i.e. >=) a specified value.

The $gte operator has the following syntax:

{field: {$gte: value} }
Code language: CSS (css)

MongDB $gte operator examples

We’ll use the following products collection:

db.products.insertMany([ { "_id" : 1, "name" : "xPhone", "price" : 799, "releaseDate": ISODate("2011-05-14"), "spec" : { "ram" : 4, "screen" : 6.5, "cpu" : 2.66 },"color":["white","black"],"storage":[64,128,256]}, { "_id" : 2, "name" : "xTablet", "price" : 899, "releaseDate": ISODate("2011-09-01") , "spec" : { "ram" : 16, "screen" : 9.5, "cpu" : 3.66 },"color":["white","black","purple"],"storage":[128,256,512]}, { "_id" : 3, "name" : "SmartTablet", "price" : 899, "releaseDate": ISODate("2015-01-14"), "spec" : { "ram" : 12, "screen" : 9.7, "cpu" : 3.66 },"color":["blue"],"storage":[16,64,128]}, { "_id" : 4, "name" : "SmartPad", "price" : 699, "releaseDate": ISODate("2020-05-14"),"spec" : { "ram" : 8, "screen" : 9.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256,1024]}, { "_id" : 5, "name" : "SmartPhone", "price" : 599,"releaseDate": ISODate("2022-09-14"), "spec" : { "ram" : 4, "screen" : 5.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256]} ])
Code language: JavaScript (javascript)

1) Using $gte operator to select documents where a field is greater than or equal to a specified value

The following example uses the $gte operator to select documents from the products collection where price is greater than 799:

db.products.find({ price: { $gte: 799 } }, { name: 1, price: 1 })
Code language: CSS (css)

The query returned the following documents:

[ { _id: 1, name: 'xPhone', price: 799 }, { _id: 2, name: 'xTablet', price: 899 }, { _id: 3, name: 'SmartTablet', price: 899 } ]
Code language: JavaScript (javascript)

2) Using the $gte operator to check if a field in an embedded document is greater than or equal to a value

The following query uses $gte operator to select documents where the value of the screen field in the spec document is greater than or equal to 9.5:

db.products.find({ "spec.screen": { $gte: 9.5 } }, { name: 1, "spec.screen": 1 })
Code language: PHP (php)

Output:

[ { _id: 2, name: 'xTablet', spec: { screen: 9.5 } }, { _id: 3, name: 'SmartTablet', spec: { screen: 9.7 } }, { _id: 4, name: 'SmartPad', spec: { screen: 9.7 } }, { _id: 5, name: 'SmartPhone', spec: { screen: 9.7 } } ]
Code language: JavaScript (javascript)

3) Using the $gte operator to check if an array element is greater than or equal to a value

The following example uses the $gte operator to query the products collection to find all documents where the array storage has at least one element greater than or equal to 512:

db.products.find({ storage: { $gte: 512 } }, { name: 1, storage: 1 })
Code language: CSS (css)

The query returned the following documents:

[ { _id: 2, name: 'xTablet', storage: [ 128, 256, 512 ] }, { _id: 4, name: 'SmartPad', storage: [ 128, 256, 1024 ] } ]
Code language: JavaScript (javascript)

4) Using the $gte operator to check if a field is after or on the same date

The following query uses the $gte operator to select documents from the products collection to find all documents where the release date is after or on 2020-05-14:

db.products.find({ "releaseDate": { $gte: new ISODate('2020-05-14') } }, { name: 1, releaseDate: 1 });
Code language: PHP (php)

The query returned the following documents:

[ { _id: 4, name: 'SmartPad', releaseDate: ISODate("2020-05-14T00:00:00.000Z") }, { _id: 5, name: 'SmartPhone', releaseDate: ISODate("2022-09-14T00:00:00.000Z") } ]
Code language: JavaScript (javascript)

Summary

  • Use the $gte operator to select documents where a field is greater than or equal to a specified value.
Was this tutorial helpful ?