$subtract（集計）

項目一覧

定義

動作
例

定義

$subtract

2 つの数値を減算してその差を返すか、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") }

戻る

$substrCP

$sum