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 を使用する場合、すべての年が異なるわけではありません 、問題の日付によって異なるためです。