$atan2（二参反正切）

最后更新：2026-10-09

$atan2（二参反正切）

$atan2根据纵坐标y与横坐标x返回方位角（弧度），参数顺序为[y, x]，能正确处理四个象限，是平面坐标转极坐标的关键操作。常用于方向计算、导航、图形旋转等场景，例如由坐标差计算朝向角。参数为null或缺失时返回null；y与x同时为0时结果无定义。与$atan不同，$atan2不会丢失象限信息，结果范围是负π到π。

📝 语法

{ $atan2: [ <纵坐标>, <横坐标> ] }

⚙️ 参数

返回值：方位角（弧度）；null或缺失返回null，y与x同时为0时无定义

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $atan2：由x、y坐标求方位角
db.points.aggregate([
  { $project: {
      bearing: { $atan2: ['$y', '$x'] }
  } }
])

运行结果：

{ '_id': 1, 'bearing': 0.7853981633974483 }
{ '_id': 2, 'bearing': -1.1071487177940904 }

📌 注意事项

• 参数顺序是先y后x，别写反
• 结果范围是负π到π，能区分四个象限
• y与x同时为0时结果无定义，先过滤该情况

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们