[Oracle Database 19c] Numeric Functions Specification | 수치 함수 상세 스펙

Numeric Functions Specification

 

수치 함수 상세 스펙

 

 

 

- Numeric Function은 단일 행을 입력받아 하나의 값을 반환하는 Single-Row Function이다.

 

 

 

* Single-Row Functions | 단일 행 함수 (URL)

[Oracle Database 19c] Single-Row Functions | 단일 행 함수

 

---

Function Summary (함수 요약)

 

 

• ABS(n)
  - n의 절댓값
   
• ACOS(n)
  - Arc Cosine n 값
  
  
• ASIN(n)
  - Arc Sine n 값
  
  
• ATAN(n)
  - Arc Tangent n 값
  
  
• ATAN2(n1, n2)
  - Arc Tangent2 n1, n2 값
   
• BITAND(expr1, expr2)
  - expr1과 expr2를 Bitwise AND 연산한 값
   
• CEIL(n)
  - n을 올림한 값
   
• COS(n)
  - Cosine n 값
   
• COSH(n)
  - Hyperbolic Cosine n 값
   
• EXP(n)
  e^n 값
  
  
• FLOOR(n)
  - n을 내림한 값
   
• LN(n)
  - ln n 값
   
• LOG(n2, n1)
  log_{n2} n1 값
   
• MOD(n2, n1)
  n2 MOD n1 값
   
• NANVL(n2, n1)
  - n2가 NaN 일 경우, n1으로 대체
   
• POWER(n2, n1)
  n2 ^ n1 값
   
• REMAINDER(n2, n1)
  - n2 MOD n1 값
   
• ROUND(n [, integer ])
  - n을 반올림한 값
   
• SIGN(n)
  - n의 부호값
   
• SIN(n)
  - Sine n 값
   
• SINH(n)
  - Hyperbolic Sine n 값
   
• SQRT(n)
  - Square Root n 값
   
• TAN(n)
  - Tangent n 값
   
• TANH(n)
  - Hyperbolic Tangent n 값
   
• TRUNC(n1 [, n2 ])
  - n1을 소수점 n2 자리 이하를 절삭한 값
   
• WIDTH_BUCKET(expr, min_value, max_value, num_buckets)
  - expr 값의 히스토그램

---

Function Specification (함수 상세 스펙)

 

 

ABS(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 절댓값을 구하고자 하는 값이다.

- n의 절댓값을 반환한다.

 

ACOS(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- Arc Cosine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다.

- Arc Cosine n 값을 반환한다.

- n은 [-1, 1] 사이의 실수값만 허용되며, [0, pi] 사이의 실수값(Radian)을 반환한다.

 

ASIN(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- Arc Sine을 구하고자 하는 값이다. - [-1, 1] 사이의 실수값만 허용된다.

- Arc Sine n 값을 반환한다.

- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.

 

ATAN(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- Arc Tangent를 구하고자 하는 값

- Arc Tangent n 값을 반환한다.

- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.

 

ATAN2(n1, n2)
-> NUMBER

Parameter	Type	Description
n1	Any Numeric Value	- Arc Tangent2를 구하고자 하는 값
n2	Any Numeric Value	- Arc Tangent2를 구하고자 하는 값

- Arc Tangent2 값을 반환한다.

- [-pi/2, pi/2] 사이의 실수값(Radian)을 반환한다.

 

BITAND(expr1, expr2)
-> NUMBER

Parameter	Type	Description
expr1	NUMBER	- Bitwise AND 를 위한 피연산자
expr2	NUMBER	- Bitwise AND 를 위한 피연산자

- expr1 과 expr2 를 Bitwise AND 연산한 결과를 반환한다.

- Argument 의 값 중 하나라도 NULL 이 입력되면, BITAND 는 NULL을 반환한다.

- expr1, expr2는 [\(-2^{n-1}\), \(2^{n-1}\)] 사이의 값만 허용되며,
  허용범위를 초과한 값이 입력될 경우, 반환값은 정의되지 않았다.

 

CEIL(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 올림할 값

- 값을 올림한다.
 

COS(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- Cosine을 구하고자 하는 값이다.

- Cosine n 값을 반환한다.

 

COSH(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- Hyperbolic Cosine을 구하고자 하는 값이다.

- Hyperbolic Cosine n 값을 반환한다.

 

EXP(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- e를 밑으로 하는 거듭제곱을 구하고자 하는 값이다.

- \(e^n\) 값을 반환한다.
  (\(e\)는 Euler's Number로 약 2.71828 이다.)

 

FLOOR(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 내림할 값이다.

- 값을 내림한다.

 

LN(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 자연로그를 구하고자 하는 값이다. - 0을 초과하는 값만 허용된다.

- Natural Logarithm n 을 반환한다.

 

LOG(n2, n1)
-> NUMBER

Parameter	Type	Description
n2	Numeric Data Type	- 로그 연산에서 Base(밑) 값이다. - 0을 초과하고, 1을 제외한 값만 허용된다.
n1	Numeric Data Type	- 로그 연산에서 진수 값이다. - 0을 초과하는 값만 허용된다.

- \(log_{n2} n1\) 값을 반환한다.

 

MOD(n2, n1)
-> Numeric Data Type

Parameter	Type	Description
n2	Numeric Data Type	- 피제수이다.
n1	Numeric Data Type	- 제수이다.

- n2 % n1 값을 반환한다.

  (n2를 n1으로 나누었을 때 나머지 값을 반환한다.)

- REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구하는 반면,

  MOD 함수는 FLOOR 함수를 통해 나머지 값을 구한다.
  

 

NANVL(n2, n1)
-> Numeric Data Type

Parameter	Type	Description
n2	BINARY_FLOAT BINARY_DOUBLE	- NaN 검사 대상이다.
n1	BINARY_FLOAT BINARY_DOUBLE	- 대체할 값이다.

- n2가 NaN 일 경우, n1을 반환한다.

- n2가 NaN 이 아닐 경우, n2를 반환한다.

 

POWER(n2, n1)
-> NUMBER        (Otherwise)
-> BINARY_DOUBLE (Argument is BINARY_FLOAT or BINARY_DOUBLE)

Parameter	Type	Description
n2	Numeric Data Type	- Base(밑) 값이다.
n1	Numeric Data Type	- Exponent(지수) 값이다. - n2가 음수일 경우,   n1은 정수만 허용된다.

- \(n2^{n1}\) 을 반환한다.

 

REMAINDER(n2, n1)
-> Numeric Data Type

 

- n2 MOD n1 값을 반환한다.

  (n2를 n1으로 나누었을 때 나머지 값을 반환한다.)

- MOD 함수는 FLOOR 함수를 통해 나머지 값을 구하는 반면,

  REMAINDER 함수는 ROUND 함수를 통해 나머지 값을 구한다.

 

 

ROUND(n [, integer ])
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 반올림 대상 값이다.
integer	Numeric Data Type	- 반올림 시 몇째 자리에서 반올림할지에 대한 값이다. - 값이 없을 경우, 0으로 지정된다.

- integer 자리까지 n을 반올림한다.

 

SIGN(n)
-> NUMBER

Parameter	Type	Description
n	Numeric Data Type	- 부호를 구하고자 하는 값이다.

- n < 0 이면 -1,
  n = 0 이면 0,

  n > 0 이면 1 을 반환한다.

- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 인 경우에 대해서는
  n < 0 이면 -1,
  n ≥ 0 이거나 n = NaN 이면 1을 반환한다.

 

SIN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE     (n is BINARY_FLOAT)

Parameter	Type	Description
n	Numeric Data Type	- Sine을 구하고자 하는 값이다.

- Sine n 값을 반환한다.

 

SINH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE     (n is BINARY_FLOAT)

Parameter	Type	Description
n	Numeric Data Type	- Hyperbolic Sine을 구하고자 하는 값이다.

- Hyperbolic Sine n 값을 반환한다.

 

SQRT(n)
-> Numeric Data Type

Parameter	Type	Description
n	Numeric Data Type	- 제곱근을 구하고자 하는 값이다.

- Square Root n 값을 반환한다.

- n이 BINARY_FLOAT 혹은 BINARY_DOUBLE 일 경우,
  n ≥ 0 이면, 양수를
  n = 0 이면, -0을
  n < 0 이면 NaN 을 반환한다.

 

TAN(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE     (n is BINARY_FLOAT)

Parameter	Type	Description
n	Numeric Data Type	- Tangent를 구하고자 하는 값이다.

- Tangent n 값을 반환한다.

TANH(n)

TANH(n)
-> Numeric Data Type (Otherwise)
-> BINARY_DOUBLE     (n is BINARY_FLOAT)

Parameter	Type	Description
n	Numeric Data Type	- Hyperbolic Tangent를 구하고자 하는 값이다.

- Hyperbolic Tangent n 값을 반환한다.

 

TRUNC(n1 [, n2 ])
-> Numeric Data Type (Otherwise)
-> Number 			 (n2 is included)

Parameter	Type	Description
n1	Numeric Data Type	- 절사하고자 하는 수이다.
n2	Numeric Data Type	- 절사할 Precision 이다.

- n2 자리까지 절사된 n1 값을 리턴한다.

- n2의 기본값은 0 이다.

- n2에서 소수점 자리수는 양수로, 정수 자리수는 음수로 표현한다.

 

WIDTH_BUCKET(expr, min_value, max_value, num_buckets)

Parameter	Type	Description
expr	Numeric Data Type, DATE	- 분할할 데이터로,   칼럼명 혹은 수식 등의 값이다.
min_value	Numeric Data Type, DATE	- expr 값 중 분할할 가장 작은 값이다.
max_value	Numeric Data Type, DATE	- expr 값 중 분할할 가장 큰 값이다.
num_buckets	Numeric Data Type (Positive Integer)	- 분할할 그룹의 개수이다.

- expr이 min_value 와 max_value 사이에서 어느 부분에 위치하고 있는지를 반환한다.

- expr이 null 이면, WIDTH_BUCKET 은 null 을 반환한다.

 

---

Reference: Oracle, SQL Language Reference : 7 Functions, URL, 2023년 4월 5일 검색