MongoDB $isoDayOfWeek

Dans MongoDB, le $isoDayOfWeek l'opérateur de pipeline d'agrégation renvoie le numéro du jour de la semaine au format ISO 8601, allant de 1 (pour lundi) à 7 (pour le dimanche).

Vous pouvez éventuellement spécifier un fuseau horaire à utiliser pour le résultat.

Le $isoDayOfWeek L'opérateur accepte soit une date (sous forme de Date, d'horodatage ou d'ObjectId), soit un document qui spécifie la date et le fuseau horaire à utiliser.

Exemple

Supposons que nous ayons une collection appelée pets avec le document suivant :

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

Nous pouvons exécuter le code suivant pour extraire le jour de la semaine ISO du born champ dans ce document.

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

Résultat :

{ "birthIsoDayOfWeek" : 4 } 

Dans ce cas, nous obtenons un résultat de 4, qui est un résultat différent de ce que j'obtiens en utilisant le $dayOfWeek opérateur sur le même document.

Ici, j'ai utilisé birthIsoDayOfWeek comme nom de champ à renvoyer, mais cela aurait pu être n'importe quoi (comme isoDayOfWeek , day , etc).

Le _id le champ est renvoyé par défaut lors de l'utilisation de projections dans MongoDB, mais dans cet exemple, j'ai explicitement caché le _id champ utilisant _id: 0 .

Spécifiez un fuseau horaire

Vous pouvez spécifier un fuseau horaire à utiliser pour la sortie du $isoDayOfWeek opérateur.

Lorsque vous faites cela, l'argument est passé à $isoDayOfWeek doit être de la forme suivante :

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

Où <dateExpression> est la date à utiliser, et <tzExpression> est le fuseau horaire à utiliser.

Le fuseau horaire peut être spécifié à l'aide de l'identifiant de fuseau horaire Olson (par exemple, "Europe/London" , "GMT" ) ou le décalage UTC (par exemple "+02:30" , "-1030" ).

Identifiant de fuseau horaire Olson

Voici un exemple qui affiche le jour dans deux fuseaux horaires différents, chacun utilisant les ID de fuseau horaire Olson :

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

Résultat :

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

Décalage UTC

Voici le même exemple, sauf que cette fois nous utilisons le décalage UTC.

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

Résultat :

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

Renvoyer le jour de la semaine à partir d'un ObjectId

Vous pouvez utiliser $isoDayOfWeek pour renvoyer la partie ISO du jour de la semaine à partir d'un ObjectId.

Les valeurs ObjectId sont des valeurs hexadécimales de 12 octets qui se composent de :

• Une valeur d'horodatage de 4 octets, représentant la création de l'ObjectId, mesurée en secondes depuis l'époque Unix.
• A 5 octets est une valeur aléatoire
• Un compteur incrémentant de 3 octets, initialisé à une valeur aléatoire.

Pour récapituler, notre document ressemble à ceci :

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

Ce document contient un ObjectId. On peut donc utiliser $isoDayOfWeek pour renvoyer le jour ISO de la semaine où notre document a été créé (ou plus précisément, lorsque le _id la valeur ObjectId du champ a été créée).

Exemple :

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

Résultat :

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

Nous pouvons voir que le document a été créé le 2ème jour de la semaine lors de l'utilisation du format ISO 8601.

Dans ce cas, j'ai également utilisé le $toDate opérateur de pipeline d'agrégation pour renvoyer la partie horodatage de l'ObjectId.