メインコンテンツまでスキップ
バージョン: 26.x

ATAN

説明​

アークタンジェント値を返します。

  • パラメータが1つの場合：xのアークタンジェントを返し、結果の範囲は[-π/2, π/2]です

  • パラメータが2つの場合：y/xのアークタンジェントを返し、ATAN2(y, x)と同じ動作をし、結果の範囲は[-π, π]です

構文​

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

パラメータ​

Parameterデスクリプション
<x>パラメータが1つの場合、逆正接として計算する必要がある値を示します。パラメータが2つの場合、水平座標（またはx値）、原点(0,0)からのx軸に沿った距離を示します。
<y>オプション。垂直座標（またはy値）、原点(0,0)からのy軸に沿った距離を表します。

戻り値​

パラメータxのatan値。

特殊ケース​

単一パラメータ版​

  • 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 = +Infinityかつxが有限の場合、π/2を返します。y = -Infinityかつxが有限の場合、-π/2を返します
  • y = +Infinityかつx = +Infinityの場合、π/4（約0.7853981633974483）を返します
  • y = -Infinityかつx = +Infinityの場合、-π/4（約-0.7853981633974483）を返します
  • y = +Infinityかつx = -Infinityの場合、3π/4（約2.356194490192345）を返します
  • y = -Infinityかつx = -Infinityの場合、-3π/4（約-2.356194490192345）を返します
  • x = +Infinityかつ有限のy > 0の場合、0を返します。有限のy < 0の場合、-0を返します
  • x = -Infinityかつ有限のy > 0の場合、πを返します。有限のy < 0の場合、-πを返します
  • 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           |
+------------------------------+