$ convertir - Amazon DocumentDB
Exemple (MongoDB Shell)Exemples de code

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

$ convertir

Nouveau depuis la version 4.0

L'$convertopérateur d'Amazon DocumentDB est utilisé pour convertir une valeur d'un type de données à un autre. Cet opérateur est utile lorsque vous devez effectuer des opérations sur des données de différents types, telles que la conversion d'une chaîne en nombre ou d'une date en horodatage.

Paramètres

  • to: type de données cible vers lequel convertir la valeur. Les valeurs prises en charge sont "string", "double", "long", "int", "date", et "boolean".

  • from: type de données actuel de la valeur. Si ce n'est pas spécifié, Amazon DocumentDB tentera de détecter automatiquement le type de données.

  • onError: (facultatif) La valeur à renvoyer en cas d'échec de la conversion. Il peut s'agir d'une valeur spécifique ou de l'une des valeurs spéciales suivantes :"null","zerofill", ou"error".

  • onNull: (facultatif) La valeur à renvoyer si la valeur d'entrée estnull. Il peut s'agir d'une valeur spécifique ou de l'une des valeurs spéciales suivantes :"null","zerofill", ou"error".

Exemple (MongoDB Shell)

L'exemple suivant montre comment convertir une valeur de chaîne en date à l'aide de l'$convertopérateur.

Création d'exemples de documents

db.users.insertMany([
  { _id: 1, name: "John Doe", joinedOn: "2022-01-01" },
  { _id: 2, name: "Jane Smith", joinedOn: "2023-02-15" },
  { _id: 3, name: "Bob Johnson", joinedOn: "invalid date" }
]);

Exemple de requête

db.users.aggregate([
  {
    $project: {
      _id: 1,
      name: 1,
      joinedOn: {
        $convert: {
          input: "$joinedOn",
          to: "date",
          onError: "null",
          onNull: "null"
        }
      }
    }
  }
])

Sortie

[
  { "_id" : 1, "name" : "John Doe", "joinedOn" : ISODate("2022-01-01T00:00:00Z") },
  { "_id" : 2, "name" : "Jane Smith", "joinedOn" : ISODate("2023-02-15T00:00:00Z") },
  { "_id" : 3, "name" : "Bob Johnson", "joinedOn" : null }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de la $convert commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

Node.js
const { MongoClient } = require("mongodb");

async function example() {
  const client = await MongoClient.connect("mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false");
  const db = client.db("test");
  const users = db.collection("users");

  const results = await users.aggregate([
    {
      $project: {
        _id: 1,
        name: 1,
        joinedOn: {
          $convert: {
            input: "$joinedOn",
            to: "date",
            onError: "null",
            onNull: "null"
          }
        }
      }
    }
  ]).toArray();

  console.log(results);
  client.close();
}

example();
Python
from pymongo import MongoClient

def example():
    client = MongoClient("mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false")
    db = client["test"]
    users = db["users"]

    results = list(users.aggregate([
        {
            "$project": {
                "_id": 1,
                "name": 1,
                "joinedOn": {
                    "$convert": {
                        "input": "$joinedOn",
                        "to": "date",
                        "onError": "null",
                        "onNull": "null"
                    }
                }
            }
        }
    ]))

    print(results)
    client.close()

example()