MongoDB Extended JSON (v2)

Uso de MongoDB Extended JSON v2

EJSON.serialize( db.<collection>.findOne() )

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

Tipos de datos BSON y sus representaciones asociadas

A continuación, se presentan algunos tipos de datos BSON comunes y las representaciones asociadas en Canónico y Relajado.

La lista completa está aquí.

Array

[ <elements> ]

<Same as Canonical>

Donde los elementos del arreglo son los siguientes:

• <elements>

  • Los elementos del arreglo utilizan JSON extendido.

  • Para especificar un arreglo vacío, omita el contenido [ ].

Binary

{ "$binary":
   {
      "base64": "<payload>",
      "subType": "<t>"
   }
}

<Same as Canonical>

Donde los valores son los siguientes:

• "<payload>"

  • String de carga útil codificada en Base64 (con relleno como "=").

• "<t>"

  • Un string hexadecimal de uno o dos caracteres que corresponde a un subtipo binario de BSON. Consulta la documentación extendida de BSON http://bsonspec.org/spec.html para los subtipos disponibles.

Date

Para fechas entre los años 1970 y 9999, inclusive:

{"$date": {"$numberLong": "<millis>"}}

{"$date": "<ISO-8601 Date/Time Format>"}

Para fechas anteriores al año 1970 o después del año 9999:

{"$date": {"$numberLong": "<millis>"}}

<Same as Canonical>

Donde los valores son los siguientes:

• "<millis>"

  • Un entero con signo de 64 bits como string. El valor representa los milisegundos en relación con el Unix epoch.

• "<ISO-8601 Date/Time Format>"

  • Una fecha en formato de fecha/hora de Internet ISO-8601 como string.

  • La fecha/hora tiene una precisión máxima de tiempo de milisegundos:

    • Los segundos fraccionarios tienen exactamente 3 lugares decimales si la parte fraccionaria no es cero.

    • De lo contrario, los segundos fraccionarios DEBERÍAN omitirse si son cero.

Decimal128

{ "$numberDecimal": "<number>" }

<Same as Canonical>

Donde los valores son los siguientes:

• "<number>"

  • Un decimal de alta precisión como string.

Document

{ <content> }

<Same as Canonical>

Donde el contenido del documento es el siguiente:

• <content>

  • Nombre: pares de valor que utilizan JSON extendido.

  • Para especificar un documento vacío, omita el contenido { }.

Double

Para números finitos:

{"$numberDouble": "<decimal string>" }

<non-integer number>

Para números infinitos o NaN:

{"$numberDouble": <"Infinity"|"-Infinity"|"NaN"> }

<Same as Canonical>

Donde los valores son los siguientes:

• "<decimal string>"

  • Un número de punto flotante con signo de 64 bits como string.

• <non-integer number>

  • Un número no entero. Los números enteros se interpretan como un entero en lugar de un doble.

Int64

{ "$numberLong": "<number>" }

<integer>

Donde los valores son los siguientes:

• "<number>"

  • Un entero con signo de 64 bits como string.

• <integer>

  • Un entero con signo de 64 bits.

Int32

{ "$numberInt": "<number>" }

<integer>

Donde los valores son los siguientes:

• "<number>"

  • Un entero con signo de 32 bits como string.

• <integer>

  • Un entero con signo de 32 bits.

MaxKey

{ "$maxKey": 1 }

<Same as Canonical>

El tipo de dato MaxKey de BSON se considera mayor que todos los demás tipos. Consulte Comparación/Orden de clasificación para obtener más información sobre el orden de comparación para los BSON types.

MinKey

{ "$minKey": 1 }

<Same as Canonical>

El tipo de dato MinKey de BSON se considera menor que todos los demás tipos. Consulte Comparación/Orden de clasificación para obtener más información sobre el orden de comparación para los BSON types.

ObjectId

{ "$oid": "<ObjectId bytes>" }

<Same as Canonical>

Donde los valores son los siguientes:

• "<ObjectId bytes>"

  • Una string hexadecimal de 24 caracteres en formato big-endian que representa los bytes de ObjectId.

Regular Expression

{ "$regularExpression":
   {
      "pattern": "<regexPattern>",
      "options": "<options>"
  }
}

<Same as Canonical>

Donde los valores son los siguientes:

• "<regexPattern>"

  • Una string que corresponde al patrón de expresión regular. La string puede contener caracteres JSON válidos y comillas dobles no escapadas ("), pero no puede contener caracteres de barra inclinada no escapada (/).

• "<options>"

  • Un string que especifica las opciones de expresión regular BSON. Debe especificar las opciones en orden alfabético. Para obtener información sobre las opciones compatibles, consulte $options.

Timestamp

{"$timestamp": {"t": <t>, "i": <i>}}

<Same as Canonical>

Donde los valores son los siguientes:

• <t>

  • Un número entero positivo para los segundos desde la epoch.

• <i>

  • Un número entero positivo para el incremento.

Ejemplos

Los siguientes ejemplos ilustran el uso de JSON extendido.

db.conversions.insertOne( { insertDate: new Date() } )

{
  acknowledged: true,
  insertedId: ObjectId("61fbaf25671c45f3f5f4074a")
}

serialized = EJSON.serialize( db.conversions.findOne() )

{
  _id: { '$oid': '61fbaf25671c45f3f5f4074a' },
  insertDate: { '$date': '2022-02-03T10:32:05.230Z' }
}

EJSON.deserialize( serialized )

{
  _id: new ObjectId( "61fbaf25671c45f3f5f4074a" ),
  insertDate: ISODate( "2022-02-03T10:32:05.230Z" )
}

stringified = EJSON.stringify( db.conversions.findOne() )

{
   "_id": {"$oid":"61fbaf25671c45f3f5f4074a"},
   "insertDate":{"$date":"2022-02-03T10:32:05.230Z"}
}

EJSON.parse( stringified )

{
  _id: new ObjectId("61fbaf25671c45f3f5f4074a"),
  insertDate: ISODate("2022-02-03T10:32:05.230Z")
}