AWS documentdb documentation change

Service: documentdb · 2026-03-31 · Documentation low

File: documentdb/latest/developerguide/toDecimal.md

Summary

Added new documentation page for the $toDecimal operator in Amazon DocumentDB, including description, parameters, MongoDB shell example, and code examples in Node.js and Python

Security assessment

This change adds documentation for a new operator ($toDecimal) that converts values to Decimal128 data type for precise decimal arithmetic. The code examples include standard TLS connection parameters (tls=true, tlsCAFile=global-bundle.pem) which are already documented security best practices for DocumentDB connections, but this is not introducing new security documentation. There is no evidence of addressing a specific security vulnerability or incident.

Diff

diff --git a/documentdb/latest/developerguide/toDecimal.md b/documentdb/latest/developerguide/toDecimal.md
index 8b1378917..00934b16e 100644
--- a//documentdb/latest/developerguide/toDecimal.md
+++ b//documentdb/latest/developerguide/toDecimal.md
@@ -0,0 +1 @@
+[](/pdfs/documentdb/latest/developerguide/developerguide.pdf#toDecimal "Open PDF")
@@ -1,0 +3,117 @@
+[Documentation](/index.html)[Amazon DocumentDB](/documentdb/index.html)[Developer Guide](what-is.html)
+
+Example (MongoDB Shell)Code examples
+
+# $toDecimal
+
+New from version 4.0
+
+The `$toDecimal` operator in Amazon DocumentDB is used to convert a value to the Decimal128 data type. This is useful when you need to perform precise decimal arithmetic or handle large decimal values that cannot be accurately represented using the Double data type.
+
+**Parameters**
+
+  * `expression`: The expression to convert to the Decimal128 data type.
+
+
+
+
+## Example (MongoDB Shell)
+
+This example demonstrates how to use the `$toDecimal` operator to convert a string value to a Decimal128 data type.
+
+**Create sample documents**
+    
+    
+    db.numbers.insertOne({ _id: 1, value: "3.14" });
+    db.numbers.insertOne({ _id: 2, value: "2.71" });
+
+**Query example**
+    
+    
+    db.numbers.aggregate([
+      { $project: {
+        _id: 1,
+        decimalValue: { $toDecimal: "$value" }
+      }}
+    ])
+
+**Output**
+    
+    
+    [
+      { "_id" : 1, "decimalValue" : Decimal128("3.14") },
+      { "_id" : 2, "decimalValue" : Decimal128("2.71") }
+    ]
+
+## Code examples
+
+To view a code example for using the `$toDecimal` command, choose the tab for the language that you want to use:
+
+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()
+
+![Warning](https://d1ge0kk1l5kms0.cloudfront.net/images/G/01/webservices/console/warning.png) **Javascript is disabled or is unavailable in your browser.**
+
+To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.
+
+[Document Conventions](/general/latest/gr/docconventions.html)
+
+$toDate
+
+$toDouble
+
+Did this page help you? - Yes
+
+Thanks for letting us know we're doing a good job!
+
+If you've got a moment, please tell us what we did right so we can do more of it.
+
+Did this page help you? - No
+
+Thanks for letting us know this page needs work. We're sorry we let you down.
+
+If you've got a moment, please tell us how we can make the documentation better.