MongoDB $toString

Depuis MongoDB 4.0, vous pouvez utiliser le $toString opérateur de pipeline d'agrégation pour convertir une valeur en chaîne.

Exemple

Supposons que nous ayons une collection appelée types et il contient le document suivant :

{
	"_id" : ObjectId("60123a54c8eb4369cf6ad9d6"),
	"double" : 123.75,
	"string" : "123",
	"boolean" : true,
	"date" : ISODate("2020-12-31T23:30:15.123Z"),
	"integer" : 123,
	"long" : NumberLong(123),
	"decimal" : NumberDecimal("123.75")
}

Nous pouvons utiliser le $toString opérateur pour convertir tous ces types en une chaîne. Si l'entrée est une chaîne, elle renvoie simplement la chaîne.

db.types.aggregate(
  [
    {
      $project:
        { 
          _id: 0,
          objectId: { $toString: "$_id" },
          double: { $toString: "$double" },
          string: { $toString: "$string" },
          boolean: { $toString: "$boolean" },
          date: { $toString: "$date" },
          integer: { $toString: "$integer" },
          long: { $toString: "$long" },
          decimal: { $toString: "$decimal" }
        }
    }
  ]
).pretty()

Résultat :

{
	"objectId" : "60123a54c8eb4369cf6ad9d6",
	"double" : "123.75",
	"string" : "123",
	"boolean" : "true",
	"date" : "2020-12-31T23:30:15.123Z",
	"integer" : "123",
	"long" : "123",
	"decimal" : "123.75"
}

Erreurs

Si vous rencontrez des erreurs, essayez d'utiliser le $convert opérateur au lieu de $toString . Le $convert vous permet de gérer les erreurs sans affecter l'ensemble de l'opération d'agrégation.

Le $toString est l'équivalent d'utiliser le $convert opérateur pour convertir une valeur en chaîne.

Voici un exemple d'utilisation de $convert pour convertir une date en chaîne ::

db.types.aggregate(
  [
    {
      $project:
        { 
          _id: 0,
          result: 
          {
            $convert: { 
              input: "$date", 
              to: "string",
              onError: "An error occurred",
              onNull: "Input was null or empty" 
            }
          }
        }
    }
  ]
)

Résultat :

{ "result" : "2020-12-31T23:30:15.123Z" }

Voir MongoDB $convert pour plus d'exemples.