MongoDB $ millionsecond

MongoDBでは、$millisecond 集計パイプライン演算子は、日付のミリ秒部分を0間の整数として返します。および999 。

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

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

例

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

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

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

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

結果：

{ "birthMilliSecond" : 123 }

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

_id MongoDBでプロジェクションを使用すると、デフォルトでフィールドが返されますが、この例では、_idを明示的に非表示にしました。 _id: 0を使用するフィールド。

タイムゾーンを指定する

$millisecondの出力に使用するタイムゾーンを指定できますオペレーター。

これを行うと、引数が$millisecondに渡されます次の形式である必要があります：

{ date: <dateExpression>, timezone: <tzExpression> }

<dateExpression>の場所は使用する日付であり、<tzExpression> 使用するタイムゾーンです。

タイムゾーンは、Olsonタイムゾーン識別子（例："Europe/London"）を使用して指定できます。、"GMT" ）またはUTCオフセット（例："+02:30" 、"-1030" 。

オルソンタイムゾーン識別子

次に、それぞれがOlsonタイムゾーンIDを使用する2つの異なるタイムゾーンでミリ秒を出力する例を示します。

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          kabul: { 
            $millisecond: { date: "$born", timezone: "Asia/Kabul" }
            },
          brisbane: { 
            $millisecond: { date: "$born", timezone: "Australia/Brisbane" }
            }
        }
    }
  ]
)

結果：

{ "kabul" : 123, "brisbane" : 123 }

タイムゾーンの変更はミリ秒の部分に影響を与えないため、結果は同じです。

UTCオフセット

この例では、UTCオフセットを使用します。

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset+04:30": { 
            $millisecond: { date: "$born", timezone: "+04:30" }
            },
          "utcOffset+05:45": { 
            $millisecond: { date: "$born", timezone: "+05:45" }
            }
        }
    }
  ]
)

結果：

{ "utcOffset+04:30" : 123, "utcOffset+05:45" : 123 }

ObjectIdからミリ秒を返す

$millisecondを使用できます ObjectIdからミリ秒の部分を返します。

ObjectId値は、以下で構成される12バイトの16進値です。

ObjectIdの作成を表す4バイトのタイムスタンプ値で、Unixエポックからの秒数で測定されます。
5バイトはランダムな値です
ランダムな値に初期化された3バイトのインクリメントカウンター。

要約すると、ドキュメントは次のようになります。

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

このドキュメントにはObjectIdが含まれています。したがって、$millisecondを使用できます。そのObjectIdからミリ秒の部分を返します。

ただし、前述のように、ObjectIdのタイムゾーン部分はUnixエポックから数秒でしか測定されないため、ミリ秒の部分は含まれていません。

例：

db.pets.aggregate(
  [
    {
      $project:
        {
          "timeStamp": { $toDate: "$_id"},
          "millisecond": { $millisecond: "$_id" }
        }
    }
  ]
).pretty()

結果：

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
	"millisecond" : 0
}

タイムスタンプにミリ秒の部分が含まれておらず、結果が0であることがわかります。。

この場合、$toDateも使用しました ObjectIdのタイムスタンプ部分を返す集約パイプライン演算子。