MongoDB $ minutes

MongoDBでは、 $ minutes 集計パイプライン演算子は、日付の分の部分を 0の間の数値として返しますおよび59 。

オプションで、結果に使用するタイムゾーンを指定できます。

$ minutes 演算子は、日付（Date、Timestamp、またはObjectIdのいずれかとして）、または使用する日付とタイムゾーンを指定するドキュメントのいずれかを受け入れます。

例

petsというコレクションがあるとします。次のドキュメントで：

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"name" : "Fetch",
	"born" : ISODate("2020-12-31T23:30:15.123Z")
}

次のコードを実行して、 bornから微細な部分を抽出できます。そのドキュメントのフィールド。

db.pets.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthMinute: { $minute: "$born" }
        }
    }
  ]
)

結果：

{ "birthMinute" : 30 }

ここでは、 birthMinuteを使用しました返すフィールド名として、ただしこれは何でもかまいません（ minutesAtBirth など）、分、など）。

 
  _id  MongoDBでプロジェクションを使用すると、デフォルトでフィールドが返されますが、この例では、 _idを明示的に非表示にしました。  _id：0を使用するフィールド 。
 タイムゾーンを指定する
 
  $ minutesの出力に使用するタイムゾーンを指定できます オペレーター。
 
 これを行うと、引数が $ minutesに渡されます 次の形式である必要があります：
 { date: <dateExpression>, timezone: <tzExpression> }
 
  の場所 は使用する日付であり、   使用するタイムゾーンです。
 
 タイムゾーンは、Olsonタイムゾーン識別子（例： "Europe / London" ）を使用して指定できます。 、 "GMT"  ）またはUTCオフセット（例： "+ 02：30"  、 "-1030"  。
 オルソンタイムゾーン識別子
 
 次に、それぞれがOlsonタイムゾーンIDを使用する2つの異なるタイムゾーンで分を出力する例を示します。
 db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          kabul: { 
            $minute: { date: "$born", timezone: "Asia/Kabul" }
            },
          katmandu: { 
            $minute: { date: "$born", timezone: "Asia/Katmandu" }
            }
        }
    }
  ]
)
 
 結果：
 { "kabul" : 0, "katmandu" : 15 } 
 UTCオフセット
 
 この例では、UTCオフセットを使用します。
 db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset+04:30": { 
            $minute: { date: "$born", timezone: "+04:30" }
            },
          "utcOffset+05:45": { 
            $minute: { date: "$born", timezone: "+05:45" }
            }
        }
    }
  ]
)
 
 結果：
 { "utcOffset+04:30" : 0, "utcOffset+05:45" : 15 } 
 ObjectIdから議事録を返す
 
  $ minutesを使用できます ObjectIdから分の部分を返します。
 
 ObjectId値は、以下で構成される12バイトの16進値です。
   ObjectIdの作成を表す4バイトのタイムスタンプ値で、Unixエポックからの秒数で測定されます。 
 5バイトはランダムな値です
 ランダムな値に初期化された3バイトのインクリメントカウンター。 
 
 
 要約すると、ドキュメントは次のようになります。
 {
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"name" : "Fetch",
	"born" : ISODate("2020-12-31T23:30:15.123Z")
}
 
 このドキュメントにはObjectIdが含まれています。したがって、 $ minutesを使用できます ドキュメントが作成された分を返します（より具体的には、 _id  フィールドのObjectId値が作成されました。
 
 例：
 db.pets.aggregate(
  [
    {
      $project:
        {
          "timeStamp": { $toDate: "$_id"},
          "minute": { $minute: "$_id" }
        }
    }
  ]
).pretty()
 
 結果：
 {
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
	"minute" : 11
}
 
 ドキュメントは、その日の1時間目の11分に作成されたことがわかります。 
 
 この場合、 $ toDateも使用しました ObjectIdのタイムスタンプ部分を返す集約パイプライン演算子。