$asin (アークサイン)

最終更新：2026-10-09

$asin (アークサイン)

$asin は数値のアークサインをラジアン単位で返します。入力は -1 から 1 の範囲でなければなりません。サイン値から角度を復元したり、座標変換に使われます。引数が null または欠落している場合は null を返します。[-1, 1] の範囲外の入力は、対応する実角度が存在しないためエラーになります。ラジアンの結果を度に変換するには $radiansToDegrees を使います。$asin は $sin の逆関数で、$sin($asin(x)) は x と等しくなります。

📝 構文

{ $asin: <numeric-expression> }

⚙️ パラメータ

戻り値：ラジアン単位の逆正弦。null または欠落している場合は null、[-1, 1] の範囲外の場合はエラー

▶ 例

以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：

// $asin: サイン値から角度（ラジアン）を復元
db.trig.aggregate([
  { $project: {
      angleRad: { $asin: '$sinValue' }
  } }
])

出力：

{ '_id': 1, 'angleRad': 1.5707963267948966 }
{ '_id': 2, 'angleRad': 0.5235987755982989 }

📌 注意事項

• 入力は -1 から 1 の範囲でなければならない。範囲外はエラーになる
• 結果はラジアン単位。$radiansToDegrees で度に変換する
• $sin の逆関数

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて