语法图

代码

atan

atan::= ATAN  "(" expr ")" 

ATAN函数返回给定参数的反正切值，参数为以弧度表示的角度，大小本身无限制（只受限于其所属数据类型所规定范围），函数返回一个大小在区间[-π/2,π/2]的数值。

本函数的规则如下：

• expr的值为数值型或可以转换为NUMBER类型的字符型（转换失败返回Invalid number错误）。对于其他类型，函数返回类型不支持。

• 当expr的值为NULL时，函数返回NULL。

• 当expr的值为Nan、Inf、-Inf时，函数处理规则受配置参数MATH_FUNC_RETURN_DECIMAL影响：

  • 若MATH_FUNC_RETURN_DECIMAL = FALSE（默认值），处理规则如下：

    expr	ATAN(expr)
    Nan	Nan
    Inf	π/2
    -Inf	-π/2

  • 若MATH_FUNC_RETURN_DECIMAL = TRUE，处理规则如下：

    expr	ATAN(expr)
    Nan、Inf、-Inf	函数返回错误

• 当expr为其他有效值时，函数返回值类型同样受配置参数MATH_FUNC_RETURN_DECIMAL影响：

  • 若MATH_FUNC_RETURN_DECIMAL = TRUE且expr的值不含FLOAT或DOUBLE类型，函数返回NUMBER类型。

  • 否则，函数返回DOUBLE类型。

示例1

SHOW PARAMETER MATH_FUNC_RETURN_DECIMAL

NAME                                           VALUE
---------------------------------------------- --------------------------------
MATH_FUNC_RETURN_DECIMAL                    FALSE

SELECT ATAN(-1) res FROM DUAL;
        RES
-----------
 -7.85E-001

SELECT ATAN(0) res FROM DUAL;
        RES
-----------
          0

SELECT ATAN(1) res FROM DUAL;
        RES
-----------
 7.854E-001

SELECT ATAN('inf') res FROM DUAL;
        RES
-----------
 1.571E+000

示例2

SHOW PARAMETER MATH_FUNC_RETURN_DECIMAL

NAME                                           VALUE
---------------------------------------------- --------------------------------
MATH_FUNC_RETURN_DECIMAL                    TRUE

SELECT ATAN(0) res FROM DUAL;
        RES
-----------
          0

SELECT ATAN('nan') res FROM DUAL;
YAS-04426 the argument value is out of range

SELECT ATAN('inf') res FROM DUAL;
YAS-04426 the argument value is out of range