$subtract(集計)
定義
動作
入力型が混在している場合、$subtract
は小さい入力型を 2 つのうち大きい方に昇格させます。型が大きいとみなされるのは、より広い範囲の値を表す場合です。数値型の最小値から最大値の順は、integer → long → double → decimal です。
演算がオーバーフローして、大きい方のデータ型で表される範囲を超えない限り、大きい方の入力型によって結果型も決まります。オーバーフローの場合、$subtract
は以下の順序に従って結果を昇格させます。
Date
と非整数のオペランドを混在させる場合、$subtract
は演算を実行する前に非整数の値を最も近い整数に四捨五入します。
例
以下のドキュメントを持つsales
コレクションを考えてみましょう。
db.sales.insertMany([ { "_id" : 1, "item" : "abc", "price" : 10, "fee" : 2, "discount" : 5, "date" : ISODate("2014-03-01T08:00:00Z") }, { "_id" : 2, "item" : "jkl", "price" : 20, "fee" : 1, "discount" : 2, "date" : ISODate("2014-03-01T09:00:00Z") } ])
数値の減算
次の集計では、$subtract
式を使用して、price
と fee
の小計から discount
を減算して total
を計算します。
db.sales.aggregate( [ { $project: { item: 1, total: { $subtract: [ { $add: [ "$price", "$fee" ] }, "$discount" ] } } } ] )
この操作は次の結果を返します。
{ "_id" : 1, "item" : "abc", "total" : 7 } { "_id" : 2, "item" : "jkl", "total" : 19 }
2 つの日付の減算
次の集計では、$subtract
式を使用して現在の日付から $date
を差し引き、システムの NOW
を使用して、ミリ秒単位で差を返します。
db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ "$$NOW", "$date" ] } } } ] )
あるいは、現在の日付に Date()
を使用することもできます。
db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ new Date(), "$date" ] } } } ] )
どちらの操作も、次のようなドキュメントを返します。
{ "_id" : 1, "item" : "abc", "dateDifference" : NumberLong("186136746187") } { "_id" : 2, "item" : "jkl", "dateDifference" : NumberLong("186133146187") }
日付からミリ秒を減算
次の集計では、$subtract
式を使用して、"$date" フィールドから 5 * 60 * 1000 ミリ秒(5 分)を減算します。
db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ "$date", 5 * 60 * 1000 ] } } } ] )
この操作は次の結果を返します。
{ "_id" : 1, "item" : "abc", "dateDifference" : ISODate("2014-03-01T07:55:00Z") } { "_id" : 2, "item" : "jkl", "dateDifference" : ISODate("2014-03-01T08:55:00Z") }