MongoDB $ isoWeekYear

MongoDBでは、$isoWeekYear 集計パイプライン演算子は、指定された日付値のISO週番号年を返します。これは、ISO8601形式の年番号です。

$isoWeekYearを使用する場合演算子の場合、オプションで結果に使用するタイムゾーンを指定できます。

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

例

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

{
	"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
	"name" : "Scratch",
	"born" : ISODate("2021-01-03T23:30:15.123Z")
}

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

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthIsoWeekYear: { $isoWeekYear: "$born" }
        }
    }
  ]
)

結果：

{ "birthIsoWeekYear" : NumberLong(2020) }

日付が2021を指定しているにもかかわらず、ISO年は実際には2020年であることがわかります。これは、ISO年が先週が終了するまで終了しないためです。そしてこの場合、その週は前年の終わりに始まり、まだ終わっていません。これがISO年の仕組みです。

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

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

タイムゾーンを指定する

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

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

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

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

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

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

次に、それぞれがオルソンのタイムゾーンIDを使用する2つの異なるタイムゾーンでISO年を出力する例を示します。

db.cats.aggregate(
  [
    {
      $project: {
          _id: 0,
          honolulu: { 
            $isoWeekYear: { date: "$born", timezone: "Pacific/Honolulu" }
            },
          auckland: { 
            $isoWeekYear: { date: "$born", timezone: "Pacific/Auckland" }
            }
        }
    }
  ]
)

結果：

{ "honolulu" : NumberLong(2020), "auckland" : NumberLong(2021) }

この場合、Pacific/Aucklandを使用すると、日付は次のISO年に進みます。タイムゾーン。

UTCオフセット

これは同じ例ですが、今回はUTCオフセットを使用しています。

db.cats.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset-1000": { 
            $isoWeekYear: { date: "$born", timezone: "-1000" }
            },
          "utcOffset+1200": { 
            $isoWeekYear: { date: "$born", timezone: "+1200" }
            }
        }
    }
  ]
)

結果：

{ "utcOffset-1000" : NumberLong(2020), "utcOffset+1200" : NumberLong(2021) }

ObjectIdからISO年を返す

$isoWeekYearを使用できます ObjectIdからISO年の部分を返します。

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

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

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

{
	"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
	"name" : "Scratch",
	"born" : ISODate("2021-01-03T23:30:15.123Z")
}

このドキュメントにはObjectIdが含まれています。したがって、$isoWeekYearを使用できますドキュメントが作成されたISO年を返します（より具体的には、_id フィールドのObjectId値が作成されました。

例：

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

結果：

{
	"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
	"timeStamp" : ISODate("2021-01-21T00:24:05Z"),
	"isoWeekYear" : NumberLong(2021)
}

ドキュメントはISO2021年に作成されたことがわかります。

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

ISO週の日付システムについて

ISOの週の日付システムは、国際標準化機構（ISO）によって発行されたISO8601の日付と時刻の標準の一部であるカレンダーシステムです。システムは、その年の通常の週の表記を定義することにより、グレゴリオ暦の上に週の年を指定します。

ISO週番号の年は、52週または53週です。これは、通常の365日または366日ではなく、1年に364日または371日があることを意味します。

ISO週は月曜日から始まります。各ISO週の年は、木曜日が該当するグレゴリオ暦の年です。 ISOの週番号は1から始まりますその年の最初の木曜日を含む週で。