$acos (アークコサイン)

最終更新：2026-10-09

$acos (アークコサイン)

$acos は数値のアークコサインをラジアン単位で返します。入力は -1 から 1 の範囲に制限されます。コサイン値から角度を復元したり、2 つのベクトルのなす角を計算するのに使われます。引数が null または欠落している場合は null を返します。[-1, 1] の範囲外の入力はエラーになります。ラジアンの結果を度に変換するには $radiansToDegrees を使います。$cos の逆関数として、0 から π ラジアン（0 から 180 度）の値を返します。

📝 構文

{ $acos: <numeric-expression> }

⚙️ パラメータ

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

▶ 例

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

// $acos: コサイン値から角度（ラジアン）を求める
db.trig.aggregate([
  { $project: {
      angle: { $acos: '$cosValue' }
  } }
])

出力：

{ '_id': 1, 'angle': 0 }
{ '_id': 2, 'angle': 1.0471975511965979 }

📌 注意事項

• 入力は -1 から 1 の範囲でなければならない。範囲外はエラーになる
• 結果はラジアン単位で、0 から π の範囲になる
• $cos の逆関数

🏷️ 関連タグ

💡 関連ケース

📚 関連チュートリアル

❓ よくある質問

Web-Tutorial 技術チーム

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

私たちについて