MongoDB $isoDayOfWeek

I MongoDB, $isoDayOfWeek aggregeringspipeline-operatören returnerar veckodagsnumret i ISO 8601-format, från 1 (för måndag) till 7 (för söndag).

Du kan valfritt ange en tidszon som ska användas för resultatet.

$isoDayOfWeek operatören accepterar antingen ett datum (som antingen ett datum, en tidsstämpel eller ett objekt-ID), eller ett dokument som anger datum och tidszon som ska användas.

Exempel

Anta att vi har en samling som heter pets med följande dokument:

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

Vi kan köra följande kod för att extrahera ISO-veckodagen från born fältet i det dokumentet.

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

Resultat:

{ "birthIsoDayOfWeek" : 4 } 

I det här fallet får vi resultatet 4, vilket är ett annat resultat än vad jag får när jag använder $dayOfWeek operatör mot samma dokument.

Här använde jag birthIsoDayOfWeek som fältnamnet att returnera, men detta kan ha varit vad som helst (som isoDayOfWeek , day , etc).

_id fältet returneras som standard när man använder projektioner i MongoDB, men i det här exemplet gömde jag uttryckligen _id fält med _id: 0 .

Ange en tidszon

Du kan ange en tidszon som ska användas för utdata från $isoDayOfWeek operatör.

När du gör detta skickades argumentet till $isoDayOfWeek måste vara av följande form:

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

Där <dateExpression> är datumet att använda och <tzExpression> är tidszonen som ska användas.

Tidszonen kan specificeras med antingen Olsons tidszonsidentifierare (t.ex. "Europe/London" , "GMT" ) eller UTC-offset (t.ex. "+02:30" , "-1030" ).

Olsons tidszonsidentifierare

Här är ett exempel som visar dagen i två olika tidszoner, som var och en använder Olsons tidszons-ID:

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

Resultat:

{ "honolulu" : 4, "auckland" : 5 }

UTC-offset

Här är samma exempel, förutom den här gången använder vi UTC-offset.

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

Resultat:

{ "utcOffset-1000" : 4, "utcOffset+1200" : 5 }

Returnera veckodagen från ett objekt-ID

Du kan använda $isoDayOfWeek för att returnera ISO-veckdagsdelen från ett ObjectId.

ObjectId-värden är hexadecimala värden på 12 byte som består av:

• Ett tidsstämpelvärde på 4 byte, som representerar objekt-ID:ts skapelse, mätt i sekunder sedan Unix-epoken.
• En 5 byte är ett slumpmässigt värde
• En 3-byte inkrementerande räknare, initierad till ett slumpmässigt värde.

För att sammanfatta ser vårt dokument ut så här:

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

Detta dokument innehåller ett ObjectId. Vi kan därför använda $isoDayOfWeek för att returnera ISO-dagen i veckan som vårt dokument skapades (eller mer specifikt, när _id fältets ObjectId-värde skapades).

Exempel:

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

Resultat:

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

Vi kan se att dokumentet skapades den andra dagen i veckan när vi använder ISO 8601-formatet.

I det här fallet använde jag också $toDate aggregeringspipeline-operatör för att returnera tidsstämpeldelen av ObjectId.