運算子會將 $mul 欄位的值乘以指定的數位。 如果欄位不存在, $mul 請建立欄位,並將它設定為零。 此運算子適用於套用百分比變更、縮放值,或對數值字段執行大量計算。
語法
{
$mul: {
<field1>: <number1>,
<field2>: <number2>,
...
}
}
參數
| 參數 | Description |
|---|---|
field |
要相乘的功能變數名稱。 |
number |
要乘以域值的數位。 必須是數值。 |
範例
請參考商店集合中的此範例檔。
{
"_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
}
]
}
]
}
範例 1:套用百分比增加
將10個% 增加套用至總銷售額(乘以1.1)。 這會從 24863 變更 totalSales 為 27349.3 (24863 × 1.1)。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"sales.totalSales": 1.1
}
}
)
範例 2:套用折扣
將 20% 折扣套用至銷售數據(乘以 0.8)。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"sales.totalSales": 0.8
}
}
)
範例 3:多個字段作業
同時將不同的乘數套用至多個字段。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"staff.totalStaff.fullTime": 1.5,
"staff.totalStaff.partTime": 2,
"sales.totalSales": 1.25
}
}
)
這會:
- 從 8 增加到
fullTime12 (8 × 1.5) - 從 5 增加到
partTime10 (5 × 2) - 增加
totalSales25% (乘以 1.25)
範例 4:建立新欄位
如果欄位不存在, $mul 請建立字段,並將它設定為 0。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"sales.bonusPoints": 100,
"staff.overtimeHours": 40
}
}
)
bonusPoints和 overtimeHours 都會以值 0 建立。
範例 5:使用十進位
針對財務計算套用精確的十進位乘數。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"sales.totalSales": 0.915
}
}
)
範例 6:更新陣列元素
使用位置運算子,將乘數套用至陣列中的特定元素。
db.stores.updateOne(
{
"_id": "438db151-04b8-4422-aa97-acf94bc69cfc",
"sales.salesByCategory.categoryName": "Direct-Drive Turntables"
},
{
$mul: {
"sales.salesByCategory.$.totalSales": 1.15
}
}
)
範例 7:負值和零
處理負乘數和零值。
db.stores.updateOne(
{ "_id": "438db151-04b8-4422-aa97-acf94bc69cfc" },
{
$mul: {
"sales.totalSales": -1,
"staff.totalStaff.fullTime": 0
}
}
)
這會:
- 使
totalSales負數 (適用於逆轉) - 將
fullTime設定為 0
將 1.5 乘數套用至員工,並將 1.25 套用至銷售後,檔會更新如下:
{
"_id": "438db151-04b8-4422-aa97-acf94bc69cfc",
"name": "Fourth Coffee | Turntable Boutique - Tromptown",
"staff": {
"totalStaff": {
"fullTime": 12,
"partTime": 10
},
"overtimeHours": 0
},
"sales": {
"totalSales": 31078.75,
"bonusPoints": 0,
"salesByCategory": [
{
"categoryName": "Direct-Drive Turntables",
"totalSales": 28592.45
}
]
}
}