MongoDBでは、 $ dateToParts 集計パイプライン演算子は、指定された日付の日付部分を返します。
具体的には、特定のBSON日付値の構成要素を個別のプロパティとして含むドキュメントを返します。
$ dateToPartsによって返される日付部分 yearです 、 month 、 day 、時間 、分 、 second およびmillisecond 。
$ dateToPartsを使用する場合 演算子の場合、オプションで結果に使用するタイムゾーンを指定できます。
$ dateToParts 演算子は、日付（Date、Timestamp、またはObjectIdのいずれかとして）、または使用する日付とタイムゾーンを指定するドキュメントのいずれかを受け入れます。
例
petsというコレクションがあるとします。 次のドキュメントで：
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
次のコードを実行して、 bornからさまざまな日付部分を返すことができます。 そのドキュメントのフィールド。
db.pets.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()結果：
{
"dateParts" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} 各日付部分が独自のフィールドに返されることがわかります。
ここでは、 datePartsを使用しました 返すフィールド名として、ただしこれは何でもかまいません（ theDate など） 等）。
_id MongoDBでプロジェクションを使用すると、デフォルトでフィールドが返されますが、この例では、 _idを明示的に非表示にしました。 _id：0を使用するフィールド 。
タイムゾーンを指定する
$ dateToPartsの出力に使用するタイムゾーンを指定できます オペレーター。
これを行うと、引数が $ dateToPartsに渡されます 次の形式である必要があります：
{ date: <dateExpression>, timezone: <tzExpression> }
の場所 は使用する日付であり、 使用するタイムゾーンです。
タイムゾーンは、Olsonタイムゾーン識別子（例： "Europe / London" ）を使用して指定できます。 、 "GMT" ）またはUTCオフセット（例： "+ 02：30" 、 "-1030" 。
オルソンタイムゾーン識別子
次に、それぞれがOlsonタイムゾーンIDを使用する2つの異なるタイムゾーンで日付部分を出力する例を示します。
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$dateToParts: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$dateToParts: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
).pretty()結果：
{
"honolulu" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 13,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"auckland" : {
"year" : 2021,
"month" : 1,
"day" : 1,
"hour" : 12,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
}
この場合、 Pacific / Auckland を使用すると、日付は翌年/月/週/日/時間に進みます。 タイムゾーン。
UTCオフセット
これは同じ例ですが、今回はUTCオフセットを使用しています。
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$dateToParts: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$dateToParts: { date: "$born", timezone: "+1200" }
}
}
}
]
).pretty()結果：
{
"utcOffset-1000" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 13,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"utcOffset+1200" : {
"year" : 2021,
"month" : 1,
"day" : 1,
"hour" : 11,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} ISOウィークデートパーツ
iso8601：trueを使用できます ISO週の日付フィールドを使用するように出力ドキュメントを変更します。これは、ISO8601標準に基づいて日付を決定します。
catsというコレクションがあるとします。 次のドキュメントで：
{
"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
"name" : "Scratch",
"born" : ISODate("2021-01-03T23:30:15.123Z")
}
次のコードを実行して、 bornからISO日付フィールドを抽出できます。 そのドキュメントのフィールド。
デモンストレーションの例を次に示します。
db.pets.aggregate(
[
{
$project: {
_id: 0,
dateParts: {
$dateToParts: {
date: "$born"
}
},
datePartsISO: {
$dateToParts: {
date: "$born",
iso8601: true
}
}
}
}
]
).pretty()結果：
{
"dateParts" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"datePartsISO" : {
"isoWeekYear" : 2020,
"isoWeek" : 53,
"isoDayOfWeek" : 4,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} 最初の出力ドキュメントは、通常の日付出力を使用します。 2番目のドキュメントでは、ISO週の日付フィールドと値を使用しています。
ObjectIdから日付パーツを返す
$ dateToPartsを使用できます ObjectIdから日付部分を返します。
ObjectId値は、以下で構成される12バイトの16進値です。
- ObjectIdの作成を表す4バイトのタイムスタンプ値で、Unixエポックからの秒数で測定されます。
- 5バイトはランダムな値です
- ランダムな値に初期化された3バイトのインクリメントカウンター。
要約すると、ドキュメントは次のようになります。
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
このドキュメントにはObjectIdが含まれています。したがって、 $ dateToPartsを使用できます ドキュメントが作成された日付に基づいて（より具体的には、 _id の場合）、日付部分を返します。 フィールドのObjectId値が作成されました。
例：
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"dateParts": { $dateToParts: { date: "$_id" } }
}
}
]
).pretty()結果：
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
"dateParts" : {
"year" : 2021,
"month" : 1,
"day" : 19,
"hour" : 1,
"minute" : 11,
"second" : 35,
"millisecond" : 0
}
}
この場合、 $ toDateも使用しました ObjectIdのタイムスタンプ部分を返す集約パイプライン演算子。