$subtract（集計）
定義
$subtract2 つの数値を減算してその差を返すか、2 つの日付を減算してその差をミリ秒単位で返すか、日付とミリ秒単位の数値を減算して結果の日付を返します。
$subtract式の構文は次のとおりです。{ $subtract: [ <expression1>, <expression2> ] } 2 番目の引数が、最初の引数から減算されます。
引数は、数値や日付に変換できる限り、どのような有効な式でも使用できます。 日付から数値を減算するには、日付を最初の引数にする必要があります。 式の詳細については、「式演算子 」を参照してください。
動作
入力型が混在している場合、$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") }