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.

# \$1 trop long
<a name="toLong"></a>

Nouveau depuis la version 4.0

L'`$toLong`opérateur dans Amazon DocumentDB est utilisé pour convertir une valeur en un type de données entier (long) de 64 bits. Cela peut être utile lorsque vous devez effectuer des opérations arithmétiques ou des comparaisons sur des valeurs numériques qui peuvent être stockées sous forme de chaînes ou d'autres types de données.

**Paramètres**
+ `expression`: expression à convertir en un entier de 64 bits.

## Exemple (MongoDB Shell)
<a name="toLong-examples"></a>

Cet exemple montre comment utiliser l'`$toLong`opérateur pour convertir une valeur de chaîne en un entier de 64 bits.

**Création d'exemples de documents**

```
db.numbers.insertMany([
  { _id: 1, value: "42" },
  { _id: 3, value: "9223372036854775807" }
]);
```

**Exemple de requête**

```
db.numbers.aggregate([
  {
    $project: {
      _id: 1,
      longValue: { $toLong: "$value" }
    }
  }
])
```

**Sortie**

```
[
  { "_id" : 1, "longValue" : 42 },
  { "_id" : 3, "longValue" : 9223372036854775807 }
]
```

## Exemples de code
<a name="toLong-code"></a>

Pour afficher un exemple de code d'utilisation de la `$toLong` 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 numbers = db.collection('numbers');

  const result = await numbers.aggregate([
    {
      $project: {
        _id: 1,
        longValue: { $toLong: "$value" }
      }
    }
  ]).toArray();

  console.log(result);
  await 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
    numbers = db.numbers

    result = list(numbers.aggregate([
        {
            '$project': {
                '_id': 1,
                'longValue': { '$toLong': '$value' }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------