View a markdown version of this page

$trunc - Amazon DocumentDB

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

$trunc

Nuevo desde la versión 8.0.1.

El $trunc operador de Amazon DocumentDB trunca un número hasta un decimal específico y elimina los dígitos sin redondear.

Parámetros

  • number: expresión que se resuelve en un número.

  • place: opcional. Expresión entera entre -20 y 100 que especifica el número de decimales a los que se debe truncar. Un valor negativo se trunca a la izquierda del decimal. El valor predeterminado es 0.

Ejemplo (MongoDB Shell)

El siguiente ejemplo muestra cómo usar el $trunc operador para truncar valores numéricos a un decimal.

Truncar con un valor posicional positivo

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

Ejemplo de consulta

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

Salida

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

Truncar con un valor posicional negativo

Cuando place es negativo, $trunc reemplaza los dígitos situados a la izquierda del decimal por ceros. En el siguiente ejemplo, se truncan los valores con el primer dígito situado a la izquierda del decimal.

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] } } } ]);

Salida

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

Ejemplos de código

Para ver un ejemplo de código sobre el uso $trunc del operador, elija la pestaña correspondiente al idioma que desee utilizar:

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()