MongoDB $isNumber

A partir do MongoDB 4.4, você pode usar o $isNumber operador de pipeline de agregação para verificar se um valor é ou não um número.

Ele aceita qualquer expressão válida e retorna true se a expressão for um número, false se não for.

Especificamente, $isNumber verifica se a expressão resolve para um dos seguintes tipos de BSON:

Integer
Decimal
Double
Long

Ele retorna true se isso acontecer.

Ele retorna false se a expressão resolver para qualquer outro tipo BSON, null , ou um campo ausente.

Exemplo

Suponha que tenhamos uma coleção chamada dogs com o seguinte documento:

{ "_id" : 1, "name" : "Fetch", "weight" : 30 }

Podemos usar o seguinte código para ver quais campos são numéricos:

db.dogs.aggregate(
  [
    {
      $project:
        { 
          _id: { $isNumber: "$_id" },
          name: { $isNumber: "$name" },
          weight: { $isNumber: "$weight" }
        }
    }
  ]
)

Resultado:

{ "_id" : true, "name" : false, "weight" : true }

Podemos ver que o _id e weight campos são numéricos, mas o name campo não é (é uma string).

Exemplo 2

Aqui está outro exemplo que contém vários campos de diferentes tipos de BSON.

Suponha que tenhamos uma coleção chamada types com o seguinte documento:

{
	"_id" : ObjectId("601738d7c8eb4369cf6ad9de"),
	"double" : 123.75,
	"string" : "123",
	"boolean" : true,
	"date" : ISODate("2020-12-31T23:30:15.123Z"),
	"integer" : 123,
	"long" : NumberLong(123),
	"decimal" : NumberDecimal("123.75"),
	"object" : {
		"a" : 1
	},
	"array" : [
		1,
		2,
		3
	]
}

Para os propósitos deste artigo, nomeei cada campo para refletir seu tipo BSON.

Agora podemos usar o seguinte código para retornar true ou false para cada campo, dependendo se o campo é um número ou não:

db.types.aggregate(
  [
    {
      $project:
        { 
          _id: { $isNumber: "$_id" },
          double: { $isNumber: "$double" },
          string: { $isNumber: "$string" },
          boolean: { $isNumber: "$boolean" },
          date: { $isNumber: "$date" },
          integer: { $isNumber: "$integer" },
          long: { $isNumber: "$long" },
          decimal: { $isNumber: "$decimal" },
          object: { $isNumber: "$object" },
          array: { $isNumber: "$array" }
        }
    }
  ]
).pretty()

Resultado:

{
	"_id" : false,
	"double" : true,
	"string" : false,
	"boolean" : false,
	"date" : false,
	"integer" : true,
	"long" : true,
	"decimal" : true,
	"object" : false,
	"array" : false
}