MongoDBは、日付を操作するためのかなりの数の集約パイプライン演算子を提供します。これには、年、月、日など、日付の特定の部分を抽出する演算子が含まれます。
カーソルを反復処理してJavaScript関数を適用できるようにするMongoDBメソッドもいくつかあります。したがって、これにより、JavaScriptを使用して、フィールドから日付値や日付部分などを抽出できます。
この記事では、MongoDBの日付から年の部分を返す6つの方法を紹介します。
サンプルデータ
cats
というコレクションがあるとします。 次のドキュメントを使用:
{ "_id" : 1, "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") } { "_id" : 2, "name" : "Meow", "born" : ISODate("2019-12-08T04:00:12Z") } { "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:30:00Z") }
次の例は、 born
から年の部分を返すためのさまざまなオプションを示しています。 それらのドキュメントのフィールド。
$ year
オペレーター
$ year
演算子は、日付から年の部分を抽出するための最も明白な選択です。日付の年の部分を含むドキュメントを返すように特別に設計されています。
次のコードを実行して、 born
から年を返すことができます。 上記のドキュメントのフィールド。
db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthYear: { $year: "$born" }
}
}
]
)
結果:
{ "birthYear" : 2021 } { "birthYear" : 2019 } { "birthYear" : 2020 }
$ year
を使用するときにタイムゾーンを指定することもできます オペレーター。
MongoDB $ year
を参照してください 詳細と例については。
$ dateToString
オペレーター
$ dateToString
演算子は、ユーザー指定の形式に従って日付オブジェクトを文字列に変換します。したがって、ユーザーは、必要に応じて年の部分だけを返すように指定できます。
日付部分ごとにフォーマット指定子があります。 %Y
フォーマット指定子は年を返します。
例:
db.cats.aggregate(
[
{
$project: {
_id: 0,
birthYear: { $dateToString: { format: "%Y", date: "$born" } }
}
}
]
)
結果:
{ "birthYear" : "2021" } { "birthYear" : "2019" } { "birthYear" : "2020" }
結果に日付部分を含めるために、より多くのフォーマット指定子を提供することもできますが、この記事では年の抽出にのみ関心があるため、1つのフォーマット指定子のみを使用しました。
MongoDB $ dateToString
を参照してください 詳細と例については。
$ dateToParts
オペレーター
$ dateToParts
演算子は、指定されたBSON日付値の構成要素を個別のプロパティとして含むドキュメントを返します。返されるプロパティはyear
です 、 month
、 day
、時間
、分コード> 、
second
およびmillisecond
。
この知識があれば、 $ dateToParts
を使用できます。 1つのパイプラインステージで、 year
を抽出する別のパイプラインステージを追加します 一部。
$ dateToParts
は次のとおりです 3つのドキュメントの返品:
db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()
結果:
{ "dateParts" : { "year" : 2021, "month" : 1, "day" : 3, "hour" : 23, "minute" : 30, "second" : 15, "millisecond" : 123 } } { "dateParts" : { "year" : 2019, "month" : 12, "day" : 8, "hour" : 4, "minute" : 0, "second" : 12, "millisecond" : 0 } } { "dateParts" : { "year" : 2020, "month" : 9, "day" : 24, "hour" : 10, "minute" : 30, "second" : 0, "millisecond" : 0 } }
このデータをパイプラインの次のステージに渡して、 year
だけを抽出できます。 フィールド。
year
だけに別の予測を追加するとどうなりますか。 フィールド:
db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
},
{
$project:
{
birthYear: "$dateParts.year"
}
}
]
)
結果:
{ "birthYear" : 2021 } { "birthYear" : 2019 } { "birthYear" : 2020 }
これは明らかに、前のオプションを使用するほど簡潔ではありません。ただし、パイプラインで何をしているのかによっては、このアプローチが便利なオプションになる可能性があります。
$ dateToParts
演算子はiso8601
も受け入れます パラメータ。ISO週の日付フィールドを使用するように出力ドキュメントを変更します。
MongoDB $ dateToParts
を参照してください 詳細と例については。
forEach()
方法
cursor.forEach()
を使用できます getFullYear()
などのJavaScriptメソッドを使用して、カーソルを反復処理します またはgetUTCFullYear()
年の値だけを返します。
db.cats.find().forEach(
function(c) {
print(
c.born.getFullYear()
);
}
);
結果:
2021 2019 2020
前のオプションは、名前と値のペアを含むドキュメント全体を返します。このオプションは、ドキュメント全体ではなく、実際の年の値のみを返します。
map()
方法
cursor.map()
メソッドは、カーソルがアクセスした各ドキュメントに関数を適用し、値を配列に結合します。
例:
db.cats.find().map(
function(c) {
c = c.born.getFullYear();
return c;
}
);
結果:
[ 2021, 2019, 2020 ]
$ isoWeekYear
オペレーター
年をISO8601形式で返す必要がある場合は、 $ isoWeekYear
を使用してください 。 ISO 8601年は、第1週の月曜日に始まり、先週の日曜日に終わります。
例:
db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthIsoWeekYear: { $isoWeekYear: "$born" }
}
}
]
)
結果:
{ "birthIsoWeekYear" : NumberLong(2020) } { "birthIsoWeekYear" : NumberLong(2019) } { "birthIsoWeekYear" : NumberLong(2020) }
前の例のように、最初の年が2021ではなく2020になっていることに注意してください。 $ isoWeekYear
を使用する場合、すべての年が異なるわけではありません 、問題の日付によって異なるためです。