Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

$dateDiff(集計)

項目一覧

  • 定義
  • 動作
$dateDiff

バージョン 5.0 で追加

2 つの日付の差を返します。

$dateDiff式の構文は次のとおりです。

{
$dateDiff: {
startDate: <Expression>,
endDate: <Expression>,
unit: <Expression>,
timezone: <tzExpression>,
startOfWeek: <String>
}
}

endDate からstartDate を差し引きます。指定された unit で整数が返されます。

フィールド
必須/オプション
説明
startDate
必須
期間の始まり。startDate は、日付タイムスタンプ、または ObjectId に変換される任意の にすることができます。
endDate
必須
期間の終了。endDate は、DateTimestamp、または ObjectId に変換される任意のにできます。
unit
必須

startDateendDate の間の、時間測定の unit。これは以下の文字列に変換されるです。

  • year

  • quarter

  • week

  • month

  • day

  • hour

  • minute

  • second

  • millisecond

timezone
任意

操作を実行するタイムゾーン。 <tzExpression>は、 Olson タイムゾーン識別子 として形式された string に変換される有効な 式 である必要があります。 または UTC オフセット 。timezoneが指定されていない場合、結果はUTCに表示されます。

形式
Olson タイムゾーン識別子
"America/New_York"
"Europe/London"
"GMT"
UTC オフセット
+/-[hh]:[mm], e.g. "+04:45"
+/-[hh][mm], e.g. "-0530"
+/-[hh], e.g. "+03"
startOfWeek
任意

単位が week と等しい場合に使用されます。デフォルトはSundayです。startOfWeek パラメータは、大文字と小文字を区別しない文字列に変換されるです。

  • monday (または mon

  • tuesday (または tue

  • wednesday (または wed

  • thursday (または thu

  • friday (または fri

  • saturday (または sat

  • sunday (または sun

Tip

以下も参照してください。

$dateDiff 式は、測定されたstartDateendDate の差を、指定された units の整数で返します。期間は、ユニット境界を通過した回数で測定されます。例、18 か月離れた 2 つの日付の場合、その差は 1.5 years ではなく 1 year で返されます。

startOfWeek パラメータによって変更されない限り、weekSunday から始まります。指定された日の startDateendDate の間に始まる週がカウントされます。週数は暦上の month または year によっては制限されません。

<timezone> フィールドで Olson タイムゾーン識別子を使用する際、指定されたタイムゾーンに該当する場合、MongoDB は DST オフセットを適用します。

たとえば、次のドキュメントを含む sales コレクションを考えます。

{
"_id" : 1,
"item" : "abc",
"price" : 20,
"quantity" : 5,
"date" : ISODate("2017-05-20T10:24:51.303Z")
}

次の集計は、MongoDB がタイムゾーン識別子の DST オフセットを取り扱う方法を示しています。この例では、$hour 演算子と $minute 演算子を使用して、date フィールドの対応する部分を返します。

db.sales.aggregate([
{
$project: {
"nycHour": {
$hour: { date: "$date", timezone: "-05:00" }
},
"nycMinute": {
$minute: { date: "$date", timezone: "-05:00" }
},
"gmtHour": {
$hour: { date: "$date", timezone: "GMT" }
},
"gmtMinute": {
$minute: { date: "$date", timezone: "GMT" } },
"nycOlsonHour": {
$hour: { date: "$date", timezone: "America/New_York" }
},
"nycOlsonMinute": {
$minute: { date: "$date", timezone: "America/New_York" }
}
}
}])

この操作では、次の結果を返します。

{
"_id": 1,
"nycHour" : 5,
"nycMinute" : 24,
"gmtHour" : 10,
"gmtMinute" : 24,
"nycOlsonHour" : 6,
"nycOlsonMinute" : 24
}

アルゴリズムは、グレゴリオ暦を使って日付の差を計算します。

うるう年とサマータイムは考慮されますが、うるう秒は考慮されません。

差が負の数で返されることがあります。

カスタマーからの注文のコレクションを作成します。

db.orders.insertMany(
[
{
custId: 456,
purchased: ISODate("2020-12-31"),
delivered: ISODate("2021-01-05")
},
{
custId: 457,
purchased: ISODate("2021-02-28"),
delivered: ISODate("2021-03-07")
},
{
custId: 458,
purchased: ISODate("2021-02-16"),
delivered: ISODate("2021-02-18")
}
]
)

次の例:

  • 配達にかかる平均日数を返します。

  • dateDiff を使用して purchased の日付と delivered の日付の差を計算します。

db.orders.aggregate(
[
{
$group:
{
_id: null,
averageTime:
{
$avg:
{
$dateDiff:
{
startDate: "$purchased",
endDate: "$delivered",
unit: "day"
}
}
}
}
},
{
$project:
{
_id: 0,
numDays:
{
$trunc:
[ "$averageTime", 1 ]
}
}
}
]
)

$group ステージの$avg アキュムレータでは、purchased の日付からdelivered の日付までの期間の取得に $dateDiff を使用します。結果の値は averageTime として返されます。

averageTime の小数点以下の値は $project ステージで切り捨てられ($trunc)、下記のような出力が生成されます。

{ "numDays" : 4.6 }

サブスクリプションの開始日と終了日を指定してこのコレクションを作成します。

db.subscriptions.insertMany(
[
{
custId: 456,
start: ISODate("2010-01-01"),
end: ISODate("2011-01-01")
},
{
custId: 457,
start: ISODate("2010-01-01"),
end: ISODate("2011-06-31")
},
{
custId: 458,
start: ISODate("2010-03-01"),
end: ISODate("2010-04-30")
}
]
)

$dateDiff 式は、整数 units で表された期間の差を返します。単位には小数部分はありません。たとえば years でカウントする場合、半年の単位はありません。

この例では unit を変更すると返される値の精度が変わることがわかります。

db.subscriptions.aggregate(
[
{
$project:
{
Start: "$start",
End: "$end",
years:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "year"
}
},
months:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "month"
}
},
days:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "day"
}
},
_id: 0
}
}
]
)

結果を次の表にまとめています。

始める
End
か月
2010-01-01
2011-01-01
1
12
365
2010-01-01
2011-07-01
1
18
546
2010-03-01
2010-04-30
0
1
60

カウントは新しいunit が開始されたときにのみ増加するため、2 行目では 18 か月が 1 年として報告され、3 行目では 60 日が 1 か月として報告されます。

月のコレクションを作成します。

db.months.insertMany(
[
{
month: "January",
start: ISODate("2021-01-01"),
end: ISODate("2021-01-31")
},
{
month: "February",
start: ISODate("2021-02-01"),
end: ISODate("2021-02-28")
},
{
month: "March",
start: ISODate("2021-03-01"),
end: ISODate("2021-03-31")
},
]
)

以下のコードを使用して、各週の始まりを変更した上で、各月の週数をカウントできます。

db.months.aggregate(
[
{
$project:
{
wks_default:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "week"
}
},
wks_monday:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "week",
startOfWeek: "Monday"
}
},
wks_friday:
{
$dateDiff:
{
startDate: "$start",
endDate: "$end",
unit: "week",
startOfWeek: "fri"
}
},
_id: 0
}
}
]
)

結果を次の表にまとめています。

Sunday
Monday
Friday
1月
5
4
4
2月
4
3
4
3月
4
4
4

結果より:

  • startOfWeek が日曜日の場合、2021 年 1 月の第 5 週 (week) は31日から始まります。

  • 31日は日曜日で、 startDate から endDateの間であるため、カウントに 1 week が追加されます。

  • 暦上の週が endDate 以降、または暦上の次の期間内に終了する場合でも、week カウントは増加します。

戻る

$dateAdd

項目一覧