$subtract（集計）
定義
$subtract2 つの数値を減算してその差を返すか、2 つの日付を減算してその差をミリ秒単位で返すか、日付とミリ秒単位の数値を減算して結果の日付を返します。
$subtract式の構文は次のとおりです。{ $subtract: [ <expression1>, <expression2> ] } 2 番目の引数が、最初の引数から減算されます。
引数は、数値や日付に変換できる限り、どのような有効な式でも使用できます。 日付から数値を減算するには、日付を最初の引数にする必要があります。 式の詳細については、「式 」を参照してください。
動作
MongoDB 5.0 以降では、その型で正確に表現できない場合を除き、結果は入力と同じ型になります。以下に例を示します。
結果が 64 ビット整数として表現可能な場合は、32 ビット整数は 64 ビット整数に変換されます。
結果が 64 ビット整数として表現不可能な場合は、32 ビット整数は double に変換されます。
結果が 64 ビット整数として表現不可能な場合は、64 ビット整数は double に変換されます。
例
以下のドキュメントを持つ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") }