$sin (正弦)
最終更新：2026-10-09
$sin (正弦)
$sin はラジアンで表した値の正弦を返します。周期信号の処理、座標変換、三角関数の計算（正弦を取る前に度をラジアンに変換するなど）に使われます。null または欠落した引数は null を返し、NaN 入力は NaN を返し、±Infinity はエラーになります。手計算で π を掛ける代わりに、$degreesToRadians で度をラジアンに（逆は $radiansToDegrees で）変換してください。
| カテゴリ | 数学 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $sin: <numeric-expression> }⚙️ パラメータ
| ラジアン値 | ラジアン単位の数値式。 |
|---|
戻り値：入力ラジアンの正弦。null または欠落している場合は null、±Infinity の場合はエラー
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// $sin: 度をラジアンに変換して正弦
db.trig.aggregate([
{ $project: {
y: { $sin: { $degreesToRadians: '$deg' } }
} }
])出力：
{ '_id': 1, 'y': 1 }
{ '_id': 2, 'y': 0.5 }📌 注意事項
- 入力はラジアン。角度は先に変換する
- ±Infinity の入力はエラーになる
- $cos や $tan のファミリー。逆関数は $asin
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q$sin は度とラジアンのどちらを取りますか？
Aラジアンです。角度の入力は先に $degreesToRadians で変換してください。
Q$sin は Infinity に何を返しますか？
Aエラーになります。無限大の正弦は未定義です。
Q$sin(30度) を計算するには？
A$sin: { $degreesToRadians: 30 } と書くと結果は 0.5 です。
