Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El operador $mod realiza una operación de módulo en el valor de un campo y selecciona documentos con un resultado especificado. Este operador es útil para buscar documentos en los que un valor de campo numérico, cuando se divide por un divisor, deja un resto específico. Normalmente sirve para paginación, datos de muestreo o patrones de búsqueda en secuencias numéricas.
Syntax
{
<field>: { $mod: [ <divisor>, <remainder> ] }
}
Parámetros
| Parámetro | Description |
|---|---|
<field> |
Campo en el que se va a realizar la operación de módulo. El campo debe contener valores numéricos. |
<divisor> |
Número por el que se va a dividir el valor del campo. Debe ser un número positivo. |
<remainder> |
Resto esperado después de la operación de módulo. Debe ser un número no negativo menor que el divisor. |
Examples
Considere este documento de ejemplo de la colección de tiendas.
{
"_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
"name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
"location": {
"lat": -89.2384,
"lon": -46.4012
},
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 20
}
},
"sales": {
"totalSales": 75670,
"salesByCategory": [
{
"categoryName": "Wine Accessories",
"totalSales": 34440
},
{
"categoryName": "Bitters",
"totalSales": 39496
},
{
"categoryName": "Rum",
"totalSales": 1734
}
]
},
"promotionEvents": [
{
"eventName": "Unbeatable Bargain Bash",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 6,
"Day": 23
},
"endDate": {
"Year": 2024,
"Month": 7,
"Day": 2
}
},
"discounts": [
{
"categoryName": "Whiskey",
"discountPercentage": 7
},
{
"categoryName": "Bitters",
"discountPercentage": 15
},
{
"categoryName": "Brandy",
"discountPercentage": 8
},
{
"categoryName": "Sports Drinks",
"discountPercentage": 22
},
{
"categoryName": "Vodka",
"discountPercentage": 19
}
]
},
{
"eventName": "Steal of a Deal Days",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
},
"endDate": {
"Year": 2024,
"Month": 9,
"Day": 29
}
},
"discounts": [
{
"categoryName": "Organic Wine",
"discountPercentage": 19
},
{
"categoryName": "White Wine",
"discountPercentage": 20
},
{
"categoryName": "Sparkling Wine",
"discountPercentage": 19
},
{
"categoryName": "Whiskey",
"discountPercentage": 17
},
{
"categoryName": "Vodka",
"discountPercentage": 23
}
]
}
]
}
Ejemplo 1: Buscar tiendas con ventas divisibles entre 1000
Esta consulta recupera almacenes donde las ventas totales son divisibles en 1000 (útiles para identificar cifras de ventas redondas).
db.stores.find({
"sales.totalSales": { $mod: [1000, 0] }
}).limit(2)
Los dos primeros resultados devueltos por esta consulta son:
[
{
"_id": "new-store-001",
"name": "TechWorld Electronics - Downtown Branch",
"sales": {
"totalSales": 5000
},
"createdDate": "2025-06-11T11:11:32.262Z",
"status": "new",
"staff": {
"totalStaff": {
"fullTime": 0,
"partTime": 0
}
},
"version": 1
},
{
"_id": "gaming-store-mall-001",
"name": "Gaming Paradise - Mall Location",
"location": {
"lat": 35.6762,
"lon": 139.6503
},
"createdDate": "2025-06-11T11:13:27.180Z",
"status": "active",
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 12
},
"manager": "Alex Johnson",
"departments": [
"gaming",
"accessories",
"repairs"
]
},
"sales": {
"totalSales": 0,
"salesByCategory": []
},
"operatingHours": {
"weekdays": "10:00-22:00",
"weekends": "09:00-23:00"
},
"metadata": {
"version": 1,
"source": "store-management-system"
}
}
]
Ejemplo 2: consulta de estilo paginación
Esta consulta recupera almacenes donde el recuento de empleados de tiempo parcial deja un resto de 0 cuando se divide entre 4 (útil para crear subconjuntos de datos).
db.stores.find({
"staff.totalStaff.partTime": { $mod: [4, 0] }
})
Los dos primeros resultados devueltos por esta consulta son:
[
{
"_id": "new-store-001",
"name": "TechWorld Electronics - Downtown Branch",
"sales": {
"totalSales": 5000
},
"createdDate": "2025-06-11T11:11:32.262Z",
"status": "new",
"staff": {
"totalStaff": {
"fullTime": 0,
"partTime": 0
}
},
"version": 1
},
{
"_id": "gaming-store-mall-001",
"name": "Gaming Paradise - Mall Location",
"location": {
"lat": 35.6762,
"lon": 139.6503
},
"createdDate": "2025-06-11T11:13:27.180Z",
"status": "active",
"staff": {
"totalStaff": {
"fullTime": 8,
"partTime": 12
},
"manager": "Alex Johnson",
"departments": [
"gaming",
"accessories",
"repairs"
]
},
"sales": {
"totalSales": 0,
"salesByCategory": []
},
"operatingHours": {
"weekdays": "10:00-22:00",
"weekends": "09:00-23:00"
},
"metadata": {
"version": 1,
"source": "store-management-system"
}
}
]