MongoDB $isoWeek

Di MongoDB, $isoWeek operator pipa agregasi mengembalikan nomor minggu dalam format ISO 8601, mulai dari 1 ke 53 .

Saat menggunakan $isoWeek operator, Anda dapat secara opsional menentukan zona waktu yang akan digunakan untuk hasil.

$isoWeek operator menerima baik tanggal (baik sebagai Tanggal, Timestamp, atau ObjectId), atau dokumen yang menentukan tanggal dan zona waktu untuk digunakan.

Contoh

Misalkan kita memiliki koleksi yang disebut cats dengan dokumen berikut:

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

Kita dapat menjalankan kode berikut untuk mengekstrak minggu ISO dari kode born bidang dalam dokumen itu.

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

Hasil:

{ "birthIsoWeek" : 53 } 

Kita dapat melihat bahwa minggu ISO sebenarnya adalah 53, meskipun tanggalnya di bulan Januari. Ini karena minggu dimulai pada akhir tahun sebelumnya, dan belum selesai. Beginilah cara kerja minggu ISO.

Di sini, saya menggunakan birthIsoWeek sebagai nama bidang yang akan dikembalikan, tetapi ini bisa berupa apa saja (seperti isoWeek , week , dll).

_id bidang dikembalikan secara default saat menggunakan proyeksi di MongoDB, tetapi dalam contoh ini saya secara eksplisit menyembunyikan _id kolom menggunakan _id: 0 .

Tentukan Zona Waktu

Anda dapat menentukan zona waktu yang akan digunakan untuk output $isoWeek operator.

Saat Anda melakukan ini, argumen diteruskan ke $isoWeek harus dalam bentuk berikut:

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

Dimana <dateExpression> adalah tanggal untuk digunakan, dan <tzExpression> adalah zona waktu yang digunakan.

Zona waktu dapat ditentukan menggunakan pengidentifikasi zona waktu Olson (mis. "Europe/London" , "GMT" ) atau offset UTC (mis. "+02:30" , "-1030" ).

Identifier Zona Waktu Olson

Berikut adalah contoh yang menampilkan minggu ISO dalam dua zona waktu berbeda, masing-masing menggunakan ID zona waktu Olson:

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

Hasil:

{ "honolulu" : 53, "auckland" : 1 } 

Dalam hal ini, tanggal bergerak maju ke minggu ISO berikutnya saat menggunakan Pacific/Auckland zona waktu.

Offset UTC

Ini contoh yang sama, kecuali kali ini kita menggunakan offset UTC.

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

Hasil:

{ "utcOffset-1000" : 53, "utcOffset+1200" : 1 }

Kembalikan Minggu ISO dari ObjectId

Anda dapat menggunakan $isoWeek untuk mengembalikan porsi minggu ISO dari ObjectId.

Nilai ObjectId adalah nilai heksadesimal 12 byte yang terdiri dari:

• Nilai cap waktu 4 byte, yang mewakili pembuatan ObjectId, diukur dalam detik sejak zaman Unix.
• 5 byte adalah nilai acak
• Penghitung pertambahan 3 byte, diinisialisasi ke nilai acak.

Untuk rekap, dokumen kami terlihat seperti ini:

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

Dokumen ini berisi ObjectId. Oleh karena itu, kita dapat menggunakan $isoWeek untuk mengembalikan minggu ISO saat dokumen kita dibuat (atau lebih khusus, ketika _id nilai ObjectId bidang telah dibuat).

Contoh:

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

Hasil:

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

Kita dapat melihat bahwa dokumen tersebut dibuat pada minggu ke-3 tahun ini dengan menggunakan format ISO 8601.

Dalam hal ini, saya juga menggunakan $toDate operator pipa agregasi untuk mengembalikan bagian stempel waktu ObjectId.

Apa itu Minggu ISO?

Sistem tanggal minggu ISO adalah sistem kalender yang merupakan bagian dari standar tanggal dan waktu ISO 8601 yang dikeluarkan oleh International Organization for Standardization (ISO). Sistem menentukan tahun minggu di atas kalender Gregorian dengan mendefinisikan notasi untuk minggu ordinal dalam setahun.

Tahun penomoran minggu ISO memiliki 52 atau 53 minggu penuh. Ini berarti ada 364 atau 371 hari dalam setahun, bukan 365 atau 366 hari biasa.

Minggu ISO dimulai dengan hari Senin. Setiap tahun dalam minggu ISO adalah tahun Gregorian di mana hari Kamis jatuh. Angka minggu ISO dimulai dari 1 dengan minggu yang berisi Kamis pertama tahun itu.