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.

# $trunc
<a name="trunc"></a>

Nouveau depuis la version 8.0.1.

Dans Amazon DocumentDB, l'`$trunc`opérateur tronque un nombre à la décimale spécifiée, en supprimant les chiffres sans les arrondir.

**Paramètres**
+ `number`: expression qui se résout en un nombre.
+ `place`: Facultatif. Expression entière comprise entre -20 et 100 qui spécifie le nombre de décimales à tronquer. Une valeur négative est tronquée à gauche de la décimale. La valeur par défaut est 0.

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

L'exemple suivant montre comment utiliser l'`$trunc`opérateur pour tronquer des valeurs numériques à une décimale près.

**Tronquer avec une valeur de position positive **

```
db.measurements.insertMany([
  {_id: 1, value: 3.456},
  {_id: 2, value: 7.891},
  {_id: 3, value: 12.345}
]);
```

**Exemple de requête **

```
db.measurements.aggregate([
  { $project: { truncated: { $trunc: ["$value", 1] } } }
]);
```

**Sortie**

```
[
  {_id: 1, truncated: 3.4},
  {_id: 2, truncated: 7.8},
  {_id: 3, truncated: 12.3}
]
```

**Tronquer avec une valeur de position négative **

Lorsque la `place` valeur est négative, `$trunc` remplace les chiffres situés à gauche de la décimale par des zéros. L'exemple suivant tronque les valeurs à l'aide du premier chiffre situé à gauche de la décimale.

```
db.samples.insertMany([
  {_id: 1, value: 19.25},
  {_id: 2, value: 28.73},
  {_id: 3, value: 34.32}
]);
```

```
db.samples.aggregate([
  { $project: { truncated: { $trunc: ["$value", -1] } } }
]);
```

**Sortie**

```
[
  {_id: 1, truncated: 10},
  {_id: 2, truncated: 20},
  {_id: 3, truncated: 30}
]
```

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

Pour afficher un exemple de code d'utilisation de l'`$trunc`opérateur, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function example() {
  const client = new MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  try {
    await client.connect();
    const db = client.db('test');
    const collection = db.collection('measurements');
    const result = await collection.aggregate([
      { $project: { truncated: { $trunc: ["$value", 1] } } }
    ]).toArray();
    console.log(result);
  } finally {
    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')
    try:
        db = client['test']
        collection = db['measurements']
        result = list(collection.aggregate([
            {'$project': {'truncated': {'$trunc': ['$value', 1]}}}
        ]))
        print(result)
    finally:
        client.close()

example()
```

------