En MongoDB, el $tan
El operador de tubería de agregación devuelve la tangente de un valor que se mide en radianes.
$tan
acepta cualquier expresión válida que se resuelva en un número.
El $tan
El operador se introdujo en MongoDB 4.2.
Ejemplo
Supongamos que tenemos una colección llamada test
con el siguiente documento:
{ "_id" : 1, "data" : 2 }
Podemos usar el $tan
operador para devolver la tangente de los data
campo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
{ "tangent" : -2.185039863261519 }
Convertir a Radianes
Como se mencionó, $tan
devuelve la tangente de un valor que se mide en radianes. Si el valor está en grados, puede usar el $degreesToRadians
operador para convertirlo a radianes.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
tangent: { $degreesToRadians: { $tan: "$data" } }
}
}
]
)
Resultado:
{ "tangent" : -0.038136139901240186 }
Valores decimales de 128 bits
De forma predeterminada, el $tan
el operador devuelve valores como double
, pero también puede devolver valores como un decimal de 128 bits siempre que la expresión se resuelva en un valor decimal de 128 bits.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 2, "data" : NumberDecimal("2.1301023541559787031443874490659") }
Ejecutemos el $tan
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
tangent: { $tan: "$data" }
}
}
]
)
Resultado:
{ "tangent" : NumberDecimal("-1.597486946407534452195921861435753") }
La salida es decimal de 128 bits.
Valores nulos
Los valores nulos devuelven null
cuando se usa el $tan
operador.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 3, "data" : null }
Ejecutemos el $tan
operador contra ese documento:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $tan: "$data" }
}
}
]
)
Resultado:
{ "result" : null }
Podemos ver que el resultado es null
.
Valores NaN
Si el argumento se resuelve en NaN
, $tan
devuelve NaN
.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: 1 * "$data" }
}
}
]
)
Resultado:
{ "result" : NaN }
Campos Inexistentes
Si el $tan
el operador se aplica a un campo que no existe, null
es devuelto.
Ejemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $tan: "$name" }
}
}
]
)
Resultado:
{ "result" : null }
Infinito
Proporcionando Infinity
o -Infinity
devuelve un error.
Supongamos que agregamos los siguientes documentos a la colección:
{ "_id" : 4, "data" : Infinity } { "_id" : 5, "data" : -Infinity }
Apliquemos $tan
a estos 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
En este caso, $tan
solo llegó hasta el primer documento (documento 4) antes de que ocurriera un error. Lo sabemos porque el mensaje de error indica que estaba intentando aplicar $tan
a inf (Infinity
).
Si eliminamos el documento 4 del filtro de consulta, podemos ver que avanza al documento 5 y devuelve el mismo error.
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
Esta vez el error muestra que estaba tratando de aplicar $tan
a -inf (-Infinity
).