V MongoDB, $sin
operátor agregačního potrubí vrací sinus hodnoty, která se měří v radiánech.
$sin
přijímá jakýkoli platný výraz, který se překládá na číslo.
$sin
operátor byl představen v MongoDB 4.2.
Příklad
Předpokládejme, že máme kolekci nazvanou test
s následujícím dokumentem:
{ "_id" : 1, "data" : 2 }
Můžeme použít $sin
operátor vrátí sinus data
pole:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
sine: { $sin: "$data" }
}
}
]
)
Výsledek:
{ "sine" : 0.9092974268256817 }
Převést na radiány
Jak již bylo zmíněno, $sin
vrátí sinus hodnoty, která se měří v radiánech. Pokud je hodnota ve stupních, můžete použít $degreesToRadians
operátor jej převede na radiány.
Příklad:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
sine: { $degreesToRadians: { $sin: "$data" } }
}
}
]
)
Výsledek:
{ "sine" : 0.015870233978020357 }
128bitové desetinné hodnoty
Ve výchozím nastavení $sin
operátor vrací hodnoty jako double
, ale může také vracet hodnoty jako 128bitové desítkové číslo, pokud se výraz převede na 128bitovou desítkovou hodnotu.
Předpokládejme, že do naší sbírky přidáme následující dokument:
{ "_id" : 2, "data" : NumberDecimal("2.1301023541559787031443874490659") }
Spusťte $sin
operátor proti tomuto dokumentu:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
sine: { $sin: "$data" }
}
}
]
)
Výsledek:
{ "sine" : NumberDecimal("0.8476235356531703096519423201190329") }
Výstup je 128bitový desítkový.
Nulové hodnoty
Hodnoty Null vrátí null
při použití $sin
operátor.
Předpokládejme, že do naší sbírky přidáme následující dokument:
{ "_id" : 3, "data" : null }
Spusťte $sin
operátor proti tomuto dokumentu:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
sine: { $sin: "$data" }
}
}
]
)
Výsledek:
{ "sine" : null }
Vidíme, že výsledek je null
.
Hodnoty NaN
Pokud je argument vyřešen na NaN
, $sin
vrátí NaN
.
Příklad:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
sine: { $sin: 1 * "$data" }
}
}
]
)
Výsledek:
{ "sine" : NaN }
Neexistující pole
Pokud $sin
operátor se použije na pole, které neexistuje, null
je vráceno.
Příklad:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
sine: { $sin: "$name" }
}
}
]
)
Výsledek:
{ "sine" : null }
Nekonečno
Poskytování Infinity
nebo -Infinity
vrátí chybu mimo rozsah.
Předpokládejme, že do sbírky přidáme následující dokument:
{ "_id" : 4, "data" : Infinity }
Spusťte $sin
znovu:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
sine: { $sin: "$data" }
}
}
]
)
Výsledek:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $sin 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