/ /

Decimal128

Overview

El tipo BSON Decimal128 es un valor de punto flotante decimal de 128bits capaz de emular el redondeo decimal con precisión exacta. Esta funcionalidad está diseñada para aplicaciones que manejan datos monetarios, como cálculos financieros y fiscales.

El MongoDB\BSON\Decimal128 La clase se puede utilizar para trabajar con este tipo en PHP.

Trabajar con valores decimales128

Insertar un decimal128

El siguiente ejemplo inserta un valor de tipo Decimal128 en el campo price de una colección llamada inventory:

<?php
$collection = (new MongoDB\Client)->test->inventory;
$collection->insertOne([
    '_id' => 1,
    'item' => '26-inch monitor',
    'price' => new MongoDB\BSON\Decimal128('428.79'),
]);
$item = $collection->findOne(['_id' => 1]);
var_dump($item);

El resultado sería entonces similar a lo siguiente:

object(MongoDB\Model\BSONDocument)#9 (1) {
  ["storage":"ArrayObject":private]=>
  array(3) {
    ["_id"]=>
    int(1)
    ["item"]=>
    string(15) "26-inch monitor"
    ["price"]=>
    object(MongoDB\BSON\Decimal128)#13 (1) {
      ["dec"]=>
      string(6) "428.79"
    }
  }
}

Operaciones matemáticas con BCMath

La extensión no proporciona ninguna funcionalidad para trabajar con Decimal128 valores; sin embargo, la representación de cadena de un objeto MongoDB\BSON\Decimal se puede128 utilizar con la extensión BCMath de PHP.

El siguiente ejemplo agrega dos Decimal128 valores y crea un nuevo Decimal128 valor con el resultado de bcadd():

<?php
$lhs = new MongoDB\BSON\Decimal128('1.234');
$rhs = new MongoDB\BSON\Decimal128('5.678');
$sum = new MongoDB\BSON\Decimal128(bcadd($lhs, $rhs));
var_dump($sum);

El resultado sería entonces similar a lo siguiente:

object(MongoDB\BSON\Decimal128)#4 (1) {
  ["dec"]=>
  string(1) "6"
}

Esto no coincide con el resultado esperado de "6.912". Cada operación de la API de BCMath utiliza una escala para determinar el número de dígitos decimales del resultado. La escala predeterminada es cero, por lo que el ejemplo anterior produce un resultado sin precisión decimal.

En el siguiente ejemplo, utilizamos una escala de tres para bcadd() para obtener el resultado esperado:

<?php
$lhs = new MongoDB\BSON\Decimal128('1.234');
$rhs = new MongoDB\BSON\Decimal128('5.678');
$sum = new MongoDB\BSON\Decimal128(bcadd($lhs, $rhs, 3));
var_dump($sum);

El resultado sería entonces similar a lo siguiente:

object(MongoDB\BSON\Decimal128)#4 (1) {
  ["dec"]=>
  string(5) "6.912"
}

En lugar de especificar una escala para cada operación, se puede establecer una escala predeterminada mediante bcscale() o la configuración INI bcmath.scale. El Decimal128 tipo admite hasta 34 dígitos decimales (es decir, dígitos significativos).

Volver

Codecs

BSON