Input in Strict Mode

The following can parse representations in strict mode with recognition of the type information.

• REST Interfaces
• mongoimport
• --query option of various MongoDB tools
• MongoDB Compass

Other JSON parsers, including mongo shell and db.eval(), can parse strict mode representations as key/value pairs, but without recognition of the type information.

Input in mongo Shell Mode

The following can parse representations in mongo shell mode with recognition of the type information.

• REST Interfaces
• mongoimport
• --query option of various MongoDB tools
• mongo shell

Output in Strict mode

mongoexport outputs data in Strict mode.

Output in mongo Shell Mode

bsondump outputs in mongo Shell mode.

Binary

data_binary

Strict Mode		mongo Shell Mode
copy { "$binary": "<bindata>", "$type": "<t>" }		copy BinData ( <t>, <bindata> )

• <bindata> is the base64 representation of a binary string.
• <t> is a representation of a single byte indicating the data type. In Strict mode it is a hexadecimal string, and in Shell mode it is an integer. See the extended bson documentation. http://bsonspec.org/spec.html

Date

data_date

Strict Mode		mongo Shell Mode
copy { "$date": "<date>" }		copy new Date ( <date> )

In Strict mode, <date> is an ISO-8601 date format with a mandatory time zone field following the template YYYY-MM-DDTHH:mm:ss.mmm<+/-Offset>.

In Shell mode, <date> is the JSON representation of a 64-bit signed integer giving the number of milliseconds since epoch UTC.

Timestamp

data_timestamp

Strict Mode		mongo Shell Mode
copy { "$timestamp": { "t": <t>, "i": <i> } }		copy Timestamp( <t>, <i> )

• <t> is the JSON representation of a 32-bit unsigned integer for seconds since epoch.
• <i> is a 32-bit unsigned integer for the increment.

Regular Expression

data_regex

Strict Mode		mongo Shell Mode
copy { "$regex": "<sRegex>", "$options": "<sOptions>" }		copy /<jRegex>/<jOptions>

• <sRegex> is a string of valid JSON characters.
• <jRegex> is a string that may contain valid JSON characters and unescaped double quote (") characters, but may not contain unescaped forward slash (/) characters.
• <sOptions> is a string containing the regex options represented by the letters of the alphabet.
• <jOptions> is a string that may contain only the characters ‘g’, ‘i’, ‘m’ and ‘s’ (added in v1.9). Because the JavaScript and mongo Shell representations support a limited range of options, any nonconforming options will be dropped when converting to this representation.

OID

data_oid

Strict Mode		mongo Shell Mode
copy { "$oid": "<id>" }		copy ObjectId( "<id>" )

<id> is a 24-character hexadecimal string.

DB Reference

data_ref

Strict Mode		mongo Shell Mode
copy { "$ref": "<name>", "$id": "<id>" }		copy DBRef("<name>", "<id>")

• <name> is a string of valid JSON characters.
• <id> is any valid extended JSON type.

Undefined Type

data_undefined

Strict Mode		mongo Shell Mode
copy { "$undefined": true }		copy undefined

The representation for the JavaScript/BSON undefined type.

You cannot use undefined in query documents. Consider the following document inserted into the people collection:

copy

db.people.insert( { name : "Sally", age : undefined } )

The following queries return an error:

copy

db.people.find( { age : undefined } )
db.people.find( { age : { $gte : undefined } } )

However, you can query for undefined values using $type, as in:

copy

db.people.find( { age : { $type : 6 } } )

This query returns all documents for which the age field has value undefined.

MinKey

data_minkey

Strict Mode		mongo Shell Mode
copy { "$minKey": 1 }		copy MinKey

The representation of the MinKey BSON data type that compares lower than all other types. See Comparison/Sort Order for more information on comparison order for BSON types.

MaxKey

data_maxkey

Strict Mode		mongo Shell Mode
copy { "$maxKey": 1 }		copy MaxKey

The representation of the MaxKey BSON data type that compares higher than all other types. See Comparison/Sort Order for more information on comparison order for BSON types.

NumberLong

data_numberlong