Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# \$1 zu Dezimal
<a name="toDecimal"></a>

Neu ab Version 4.0

Der `$toDecimal` Operator in Amazon DocumentDB wird verwendet, um einen Wert in den Decimal128-Datentyp zu konvertieren. Dies ist nützlich, wenn Sie präzise Dezimalarithmetik durchführen oder große Dezimalwerte verarbeiten müssen, die mit dem Double-Datentyp nicht genau dargestellt werden können.

**Parameter**
+ `expression`: Der Ausdruck, der in den Decimal128-Datentyp konvertiert werden soll.

## Beispiel (MongoDB Shell)
<a name="toDecimal-examples"></a>

Dieses Beispiel zeigt, wie der `$toDecimal` Operator verwendet wird, um einen Zeichenkettenwert in einen Decimal128-Datentyp zu konvertieren.

**Erstellen Sie Beispieldokumente**

```
db.numbers.insertOne({ _id: 1, value: "3.14" });
db.numbers.insertOne({ _id: 2, value: "2.71" });
```

**Beispiel für eine Abfrage**

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

**Ausgabe**

```
[
  { "_id" : 1, "decimalValue" : Decimal128("3.14") },
  { "_id" : 2, "decimalValue" : Decimal128("2.71") }
]
```

## Codebeispiele
<a name="toDecimal-code"></a>

Um ein Codebeispiel für die Verwendung des `$toDecimal` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ 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 collection = db.collection('numbers');

  const result = await collection.aggregate([
    { $project: {
      _id: 1,
      decimalValue: { $toDecimal: "$value" }
    }}
  ]).toArray();

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

    result = list(collection.aggregate([
        {'$project': {
            '_id': 1,
            'decimalValue': {'$toDecimal': '$value'}
        }}
    ]))

    print(result)
    client.close()

example()
```

------