大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:ATAN

· 52CE 我爱测

## 描述 返回反正切值。 - 当只有一个参数时:返回 的反正切值,结果范围为 [-π/2, π/2] - 当有两个参数时:返回 的反正切值,行为与 ATAN2(y, x) 相同,结果范围为 [-π, π] ## 语法 ## 参数 | 参数 | 说明 | | -- | -- | | | 当只有一个参数时,表示需要被计算反正切的值;当有两个参数时,表示水平坐标(或 x 值),从原点 (0,0) 沿 x 轴的距离 | | | 可选参数,表示

描述

返回反正切值。

  • 当只有一个参数时:返回 x 的反正切值,结果范围为 [-π/2, π/2]
  • 当有两个参数时:返回 y/x 的反正切值,行为与 ATAN2(y, x) 相同,结果范围为 [-π, π]

语法

ATAN([<y>, ]<x>)

参数

参数 说明
<x> 当只有一个参数时,表示需要被计算反正切的值;当有两个参数时,表示水平坐标(或 x 值),从原点 (0,0) 沿 x 轴的距离
<y> 可选参数,表示垂直坐标(或 y 值),从原点 (0,0) 沿 y 轴的距离

返回值

  • 单参数时:参数 x 的反正切值
  • 双参数时:参数 y/x 的反正切值

特殊情况

单参数版本

  • 当 x 为 NaN,返回 NaN
  • 当 x 为正无穷,返回 π/2(约 1.570796326794897)
  • 当 x 为负无穷,返回 -π/2(约 -1.570796326794897)
  • 当 x 为 NULL,返回 NULL

双参数版本

  • 若 y 或 x 为 NaN,返回 NaN
  • 当 x > 0 且 y = ±0.0,返回 ±0(符号同 y)
  • 当 x = 0.0(含 +0.0 与 -0.0)且 y > 0,返回 π/2(约 1.570796326794897)
  • 当 x = 0.0(含 +0.0 与 -0.0)且 y < 0,返回 -π/2(约 -1.570796326794897)
  • 当 x < 0 且 y = +0.0,返回 π(约 3.141592653589793);当 x < 0 且 y = -0.0,返回 -π
  • 当 y = +∞、x 有限,返回 π/2;当 y = -∞、x 有限,返回 -π/2
  • 当 y = +∞ 且 x = +∞,返回 π/4(约 0.7853981633974483)
  • 当 y = -∞ 且 x = +∞,返回 -π/4(约 -0.7853981633974483)
  • 当 y = +∞ 且 x = -∞,返回 3π/4(约 2.356194490192345)
  • 当 y = -∞ 且 x = -∞,返回 -3π/4(约 -2.356194490192345)
  • 当 x = +∞ 且 y 有限为正,返回 0;当 x = +∞ 且 y 有限为负,返回 -0
  • 当 x = -∞ 且 y 有限为正,返回 π;当 x = -∞ 且 y 有限为负,返回 -π
  • 当 y 或 x 为 NULL,返回 NULL

举例

select atan(0);
+-----------+
| atan(0.0) |
+-----------+
|         0 |
+-----------+
select atan(2);
+--------------------+
| atan(2.0)          |
+--------------------+
| 1.1071487177940904 |
+--------------------+
select atan(cast('nan' as double));
+-----------------------------+
| atan(cast('nan' AS DOUBLE)) |
+-----------------------------+
| NaN                         |
+-----------------------------+
select atan(cast('inf' as double));
+-----------------------------+
| atan(cast('inf' AS DOUBLE)) |
+-----------------------------+
| 1.570796326794897           |
+-----------------------------+
select atan(cast('-inf' as double));
+------------------------------+
| atan(cast('-inf' AS DOUBLE)) |
+------------------------------+
| -1.570796326794897           |
+------------------------------+
select atan(cast('nan' as double), 1.0);
+----------------------------------+
| atan(cast('nan' as double), 1.0) |
+----------------------------------+
|                              NaN |
+----------------------------------+
select atan(-1.0, cast('inf' as double));
+-----------------------------------+
| atan(-1.0, cast('inf' as double)) |
+-----------------------------------+
|                                -0 |
+-----------------------------------+
select atan(cast('-inf' as double), cast('inf' as double));
+-----------------------------------------------------+
| atan(cast('-inf' as double), cast('inf' as double)) |
+-----------------------------------------------------+
|                                 -0.7853981633974483 |
+-----------------------------------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。