MongoDBでは、$isoWeek
集計パイプライン演算子は、1
の範囲の週番号をISO8601形式で返します 53
へ 。
$isoWeek
を使用する場合 演算子の場合、オプションで結果に使用するタイムゾーンを指定できます。
$isoWeek
演算子は、日付(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,
birthIsoWeek: { $isoWeek: "$born" }
}
}
]
)
結果:
{ "birthIsoWeek" : 53 }
日付が1月であるにもかかわらず、ISO週は実際には53であることがわかります。これは、その週が前年末に始まり、まだ終わっていないためです。これがISO週の仕組みです。
ここでは、birthIsoWeek
を使用しました 返すフィールド名として、ただしこれは何でもかまいません(isoWeek
など) 、week
、など)。
_id
MongoDBでプロジェクションを使用すると、デフォルトでフィールドが返されますが、この例では、_id
を明示的に非表示にしました。 _id: 0
を使用するフィールド 。
タイムゾーンを指定する
$isoWeek
の出力に使用するタイムゾーンを指定できます オペレーター。
これを行うと、引数が$isoWeek
に渡されます 次の形式である必要があります:
{ date: <dateExpression>, timezone: <tzExpression> }
<dateExpression>
の場所 は使用する日付であり、<tzExpression>
使用するタイムゾーンです。
タイムゾーンは、Olsonタイムゾーン識別子(例:"Europe/London"
)を使用して指定できます。 、"GMT"
)またはUTCオフセット(例:"+02:30"
、"-1030"
。
オルソンタイムゾーン識別子
次に、それぞれがOlsonタイムゾーンIDを使用する2つの異なるタイムゾーンでISO週を出力する例を示します。
db.cats.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$isoWeek: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$isoWeek: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
)
結果:
{ "honolulu" : 53, "auckland" : 1 }
この場合、Pacific/Auckland
を使用すると、日付は次のISO週に進みます。 タイムゾーン。
UTCオフセット
これは同じ例ですが、今回はUTCオフセットを使用しています。
db.cats.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$isoWeek: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$isoWeek: { date: "$born", timezone: "+1200" }
}
}
}
]
)
結果:
{ "utcOffset-1000" : 53, "utcOffset+1200" : 1 }
ObjectIdからISO週を返す
$isoWeek
を使用できます ObjectIdからISO週の部分を返します。
ObjectId値は、以下で構成される12バイトの16進値です。
- ObjectIdの作成を表す4バイトのタイムスタンプ値で、Unixエポックからの秒数で測定されます。
- 5バイトはランダムな値です
- ランダムな値に初期化された3バイトのインクリメントカウンター。
要約すると、ドキュメントは次のようになります。
{ "_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"), "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") }
このドキュメントにはObjectIdが含まれています。したがって、$isoWeek
を使用できます ドキュメントが作成されたISO週を返します(より具体的には、_id
フィールドのObjectId値が作成されました。
例:
db.cats.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"isoWeek": { $isoWeek: "$_id" }
}
}
]
).pretty()
結果:
{ "_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"), "timeStamp" : ISODate("2021-01-21T00:24:05Z"), "isoWeek" : 3 }
ISO 8601形式を使用した場合、ドキュメントはその年の第3週に作成されたことがわかります。
この場合、$toDate
も使用しました ObjectIdのタイムスタンプ部分を返す集約パイプライン演算子。
ISOウィークとは何ですか?
ISOの週の日付システムは、国際標準化機構(ISO)によって発行されたISO8601の日付と時刻の標準の一部であるカレンダーシステムです。システムは、その年の通常の週の表記を定義することにより、グレゴリオ暦の上に週の年を指定します。
ISO週番号の年は、52週または53週です。これは、通常の365日または366日ではなく、1年に364日または371日があることを意味します。
ISO週は月曜日から始まります。各ISO週の年は、木曜日が該当するグレゴリオ暦の年です。 ISOの週番号は1
から始まります その年の最初の木曜日を含む週で。