No MongoDB, o
$tan
o operador de pipeline de agregação retorna a tangente de um valor medido em radianos. $tan
aceita qualquer expressão válida que resolva para um número. O
$tan
O operador foi introduzido no MongoDB 4.2. Exemplo
Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 2 }
Podemos usar o
$tan
operador para retornar a tangente dos data
campo:db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
{ "tangent" : -2.185039863261519 }
Converter para radianos
Como mencionado,
$tan
retorna a tangente de um valor medido em radianos. Se o valor estiver em graus, você pode usar o $degreesToRadians
operador para convertê-lo em radianos. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $degreesToRadians: { $tan: "$data" } }
}
}
]
)
Resultado:
{ "tangent" : -0.038136139901240186 }
Valores decimais de 128 bits
Por padrão, o
$tan
operador retorna valores como um double
, mas também pode retornar valores como um decimal de 128 bits, desde que a expressão resolva para um valor decimal de 128 bits. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 2, "data" : NumberDecimal("2.1301023541559787031443874490659") }
Vamos executar o
$tan
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
{ "tangent" : NumberDecimal("-1.597486946407534452195921861435753") }
A saída é decimal de 128 bits.
Valores nulos
Valores nulos retornam
null
ao usar o $tan
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 3, "data" : null }
Vamos executar o
$tan
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $tan: "$data" }
}
}
]
)
Resultado:
{ "result" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento for resolvido para
NaN
, $tan
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: 1 * "$data" }
}
}
]
)
Resultado:
{ "result" : NaN }
Campos inexistentes
Se o
$tan
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: "$name" }
}
}
]
)
Resultado:
{ "result" : null }
Infinito
Fornecendo
Infinity
ou -Infinity
retorna um erro. Suponha que adicionamos os seguintes documentos à coleção:
{ "_id" : 4, "data" : Infinity } { "_id" : 5, "data" : -Infinity }
Vamos aplicar
$tan
a estes documentos:db.test.aggregate(
[
{ $match: { _id: { $in: [ 4, 5 ] } } },
{ $project: {
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $tan to inf, value must in (-inf,inf)", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Neste caso,
$tan
só chegou até o primeiro documento (documento 4) antes de ocorrer um erro. Sabemos disso porque a mensagem de erro indica que estava tentando aplicar $tan
para inf (Infinity
). Se removermos o documento 4 do filtro de consulta, podemos ver que ele avança para o documento 5 e retorna o mesmo erro.
db.test.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{ $project: {
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $tan to -inf, value must in (-inf,inf)", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Desta vez o erro mostra que estava tentando aplicar
$tan
para -inf (-Infinity
).