日期

所述mongo外壳提供了各种方法来返回日期,无论是作为一个字符串或作为Date对象:

  • Date() 以字符串形式返回当前日期的方法。
  • new Date()构造函数,Date使用ISODate()包装器返回对象 。
  • ISODate()构造函数,Date使用ISODate()包装器返回对象 。

在内部,Date对象存储为带符号的64位整数,表示自Unix纪元(1970年1月1日)以来的毫秒数。

并非所有的数据库操作和驱动程序都支持完整的64位范围。您可以放心使用介于0到9999之间的年份的日期。

返回日期作为字符串

要以字符串形式返回日期,请使用Date()方法,如以下示例所示:

1
var myDateString = Date();

要打印变量的值,请在shell中键入变量名称,如下所示:

1
myDateString

结果是myDateString的值:

1
Wed Dec 19 2012 01:03:25 GMT-0500 (EST)

要验证类型,请使用typeof运算符,如下所示:

1
typeof myDateString

操作返回string。

返回Date

mongo shell使用ISODate帮助器包装Date类型的对象;但是,对象仍为日期类型。

下面的示例使用新的Date()构造函数和ISODate()构造函数返回Date对象。

1
2
var myDate = new Date();
var myDateInitUsingISODateWrapper = ISODate();

您也可以将new运算符与ISODate()构造函数一起使用。

要打印变量的值,请在shell中键入变量名称,如下所示:

1
myDate

结果是包装在 帮助器中的Date值:myDateISODate()

1
ISODate("2012-12-19T06:01:17.171Z")

要验证类型,请使用instanceof运算符,如下所示:

1
2
myDate instanceof Date
myDateInitUsingISODateWrapper instanceof Date

true两者都返回操作。

ObjectId

mongo shell提供了围绕ObjectId数据类型的ObjectId()包装器类。要生成新的ObjectId,请在mongo shell中使用以下操作:

1
new ObjectId

返回一个新的ObjectId值。12字节的ObjectId 值包括:

  • 一个4字节的时间戳记值,代表自Unix时代以来以秒为单位的ObjectId的创建
  • 5字节随机值
  • 3字节递增计数器,初始化为随机值

虽然BSON格式本身是低位字节序,但时间戳和 计数器值却是高位字节序,最高有效字节出现在字节序列中。

ObjectId() 可以接受以下参数:

领域 类型 描述
hexadecimal 可选的。新ObjectId的十六进制字符串值。

方法和属性

ObjectId() 具有以下属性和方法:

属性/方法 描述
str 返回对象的十六进制字符串表示形式。
ObjectId.getTimestamp() 返回对象的时间戳部分作为日期。
ObjectId.toString() 以字符串文字“ ObjectId(…)” 的形式返回JavaScript表示形式。
ObjectId.valueOf() 以十六进制字符串形式返回对象的表示形式。返回的字符串是str属性。

例子

生成新的ObjectId

要生成一个新的ObjectId,请使用ObjectId()不带参数的方法:

1
x = ObjectId()

在此示例中,x的值为:

1
ObjectId("507f1f77bcf86cd799439011")

指定一个十六进制字符串

要使用具有唯一十六进制字符串的ObjectId()生成新的ObjectId,请执行以下操作 :

1
y = ObjectId("507f191e810c19729de860ea")

在此示例中,y的值为:

1
ObjectId("507f191e810c19729de860ea")

进入十六进制字符串

访问ObjectId()对象的str属性,如下所示:

1
ObjectId("507f191e810c19729de860ea").str

此操作将返回以下十六进制字符串:

1
507f191e810c19729de860ea

NumberLong

mongoshell默认情况下会将所有数字视为浮点值。 mongoshell提供了NumberLong()包装器来处理64位整数。

NumberLong()包装器接受long作为字符串:

1
NumberLong("2090845886852")

以下示例使用NumberLong()包装器写入集合:

1
2
3
4
5
db.collection.insertOne( { _id: 10, calc: NumberLong("2090845886852") } )
db.collection.updateOne( { _id: 10 },
                      { $set:  { calc: NumberLong("2555555000000") } } )
db.collection.updateOne( { _id: 10 },
                      { $inc: { calc: NumberLong(5) } } )

检索文档以验证:

1
db.collection.findOne( { _id: 10 } )

在返回的文档中,该calc字段包含一个 NumberLong对象:

1
{ "_id" : 10, "calc" : NumberLong("2555555000005") }

如果使用$inc通过浮点数增加包含NumberLong对象的字段的值,则数据类型将更改为浮点值,如以下示例所示:

1.使用$inc将calc字段增加5,mongo shell将其视为浮点数:

1
2
db.collection.updateOne( { _id: 10 },
                      { $inc: { calc: 5 } } )

2.检索更新的文档:

1
db.collection.findOne( { _id: 10 } )

在更新的文档中,该calc字段包含一个浮点值:

1
{ "_id" : 10, "calc" : 2555555000010 }

NumberInt

mongo默认情况下,Shell将所有数字视为浮点值。该mongo外壳提供了NumberInt() 构造函数来显式地指定32位整数。

NumberDecimal

3.4版的新功能。

默认情况下,mongoShell将所有数字视为64位浮点 double值。所述mongo外壳提供了 NumberDecimal()构造,以明确指定的128位为基础的十进制能够模拟与小数精度精确舍入的浮点值。此功能适用于处理 货币数据(例如金融,税收和科学计算)的应用程序。

十进制BSON类型使用IEEE 754十进制128浮点编号格式,该格式支持34个十进制数字(即有效数字)和-6143至+6144的指数范围。

NumberDecimal()构造函数接受十进制值作为字符串:

1
NumberDecimal("1000.55")

该值存储在数据库中,如下所示:

1
NumberDecimal("1000.55")

该NumberDecimal()构造也接受double来自值mongoShell(即不带引号),虽然这不是推荐,因为失去精度的风险。构造函数创建一个基于二进制的double精度表示形式,该精度表示基于十进制的参数(可能会丢失精度),然后将该值转换decimal为精度为15位数字的值。下面的示例隐式地将值作为双精度值传递,并显示如何以15位精度创建值:

1
NumberDecimal(1000.55)

该值存储在数据库中,如下所示:

1
NumberDecimal("1000.55000000000")

下面的示例隐式地将该值作为双精度值传递,并说明如何发生精度损失:

1
NumberDecimal(9999999.4999999999)

该值存储在数据库中,如下所示:

1
NumberDecimal("9999999.50000000")

注意

要将decimal数据类型与MongoDB驱动程序一起使用,请确保使用支持该数据类型 的驱动程序。

相等和排序

将decimal类型的值与其他数字类型进行比较,并根据它们的实际数字值对其进行排序。基于二进制的double类型的数字值通常具有基于十进制的值的近似表示,并且可能与它们的decimal表示不完全相同,因此在检查十进制值的相等性时,请使用NumberDecimal()构造函数。考虑以下示例,并在数字集合中包含以下文档:

1
2
3
4
5
{ "_id" : 1, "val" : NumberDecimal( "9.99" ), "description" : "Decimal" }
{ "_id" : 2, "val" : 9.99, "description" : "Double" }
{ "_id" : 3, "val" : 10, "description" : "Double" }
{ "_id" : 4, "val" : NumberLong(10), "description" : "Long" }
{ "_id" : 5, "val" : NumberDecimal( "10.0" ), "description" : "Decimal" }

将下表中的查询插入db.numbers.find(<query>)方法时,将返回以下结果:

第一个查询{“ val”:9.99}隐式搜索9.99的双精度表示形式,该表示形式不等于该值的十进制表示形式。

NumberDecimal()构造函数用于查询以9.99十进制表示的文档。排除双精度类型的值,因为它们与9.99的十进制表示形式的确切值不匹配。

查询整数时,将返回所有数字类型的匹配值。例如,查询10的双精度表示将在结果中包含10.0的十进制表示,反之亦然。

检查decimal类型

要测试decimal类型,请使用$type字符串别名"decimal"或的操作符19,该数字为该decimal类型的数字代码 。

1
db.inventory.find( { price: { $type: "decimal" } } )

在mongoShell中检查类型

为了确定字段的类型,mongoshell提供了instanceofand typeof运算符。

instanceof

instanceof 返回一个布尔值以测试值是否是某种类型的实例。

例如,以下操作测试_id字段是否为ObjectId类型的实例:

1
mydoc._id instanceof ObjectId

操作返回true。

typeof

typeof 返回字段的类型。

例如,以下操作返回_id 字段的类型:

1
typeof mydoc._id

在这种情况下,typeof将返回更通用的object类型而不是ObjectId类型。