> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Math

> 算術関数は、データに対してさまざまな数学的演算を実行します。

## ABS

指定された数値式の絶対値（正の値）を返します。

**構文**

```bash theme={null}
ABS(numeric_expression)
```

**パラメータ**

* **numeric\_expression** bit データ型を除く、不定の数値データ型の式。

**例**

```sql theme={null}
SELECT ABS(15);
-- Result: 15

SELECT ABS(-15);
-- Result: 15
```

## ACOS

逆余弦、すなわちコサインが指定された float 式となる角度をラジアンで返します。

**構文**

```bash theme={null}
ACOS(float_expression)
```

**パラメータ**

* **float\_expression** 返される角度のコサインを指定する float 式。-1 から 1 の範囲外の値の場合は null を返します。

**例**

```sql theme={null}
SELECT ACOS(0.5);
-- Result: 1.0471975511966
```

## ASIN

逆正弦、すなわちサインが指定された float 式となる角度をラジアンで返します。

**構文**

```bash theme={null}
ASIN(float_expression)
```

**パラメータ**

* **float\_expression** 返される角度のサインを指定する float 式。-1 から 1 の範囲外の値の場合は null を返します。

**例**

```sql theme={null}
SELECT ASIN(0.5);
-- Result: 0.523598775598299
```

## ATAN

逆正接、すなわちタンジェントが指定された float 式となる角度をラジアンで返します。

**構文**

```bash theme={null}
ATAN(float_expression)
```

**パラメータ**

* **float\_expression** 返される角度のタンジェントを指定する float 式。

**例**

```sql theme={null}
SELECT ATAN(10);
-- Result: 1.47112767430373
```

## ATN2

正の x 軸と、原点から点 (y, x) への半直線との間の角度をラジアンで返します。ここで x と y は指定された 2 つの float 式の値です。

**構文**

```bash theme={null}
ATN2(float_expression1, float_expression2)
```

**パラメータ**

* **float\_expression1** y 座標となる float 式。
* **float\_expression2** x 座標となる float 式。

**例**

```sql theme={null}
SELECT ATN2(1, 1);
-- Result: 0.785398163397448
```

## CEILING

指定された数値式以上の最小の整数を返します。

**構文**

```bash theme={null}
CEILING ( numeric_expression ) or CEIL( numeric_expression )
```

**パラメータ**

* **numeric\_expression** bit データ型を除く、不定の数値データ型の式。

**例**

```sql theme={null}
SELECT CEILING(1.3);
-- Result: 2

SELECT CEILING(1.5);
-- Result: 2

SELECT CEILING(1.7);
-- Result: 2
```

## COS

指定された式で示されるラジアン単位の角度の三角関数コサインを返します。

**構文**

```bash theme={null}
COS(float_expression)
```

**パラメータ**

* **float\_expression** 指定された角度をラジアンで表す float 式。

**例**

```sql theme={null}
SELECT COS(1);
-- Result: 0.54030230586814
```

## COT

float\_expression で指定されたラジアン単位の角度の三角関数コタンジェントを返します。

**構文**

```bash theme={null}
COT(float_expression)
```

**パラメータ**

* **float\_expression** ラジアン単位の角度を表す float 式。

**例**

```sql theme={null}
SELECT COT(1);
-- Result: 0.642092615934331
```

## DEGREES

ラジアンで指定された角度を度数で返します。

**構文**

```bash theme={null}
DEGREES(numeric_expression)
```

**パラメータ**

* **numeric\_expression** ラジアン単位の角度。bit データ型を除く、不定の数値データ型の式。

**例**

```sql theme={null}
SELECT DEGREES(3.1415926);
-- Result: 179.999996929531
```

## EXP

指定された float 式の指数値を返します。例えば、EXP(LOG(20)) は 20 になります。

**構文**

```bash theme={null}
EXP(float_expression)
```

**パラメータ**

* **float\_expression** float 式。

**例**

```sql theme={null}
SELECT EXP(2);
-- Result: 7.38905609893065
```

## EXPR

式を評価します。

**構文**

```bash theme={null}
EXPR(expression)
```

**パラメータ**

* **expression** 式。使用できる演算子は `+, -, \*, /, ==, !=, >, <, >=, and <=` です。

**例**

```sql theme={null}
SELECT EXPR('1 + 2 * 3');
-- Result: 7

SELECT EXPR('1 + 2 * 3 == 7');
-- Result: true
```

## FLOOR

数値式以下の最大の整数を返します。

**構文**

```bash theme={null}
FLOOR(numeric_expression)
```

**パラメータ**

* **numeric\_expression** bit データ型を除く、不定の数値データ型の式。

**例**

```sql theme={null}
SELECT FLOOR(1.3);
-- Result: 1

SELECT FLOOR(1.5);
-- Result: 1

SELECT FLOOR(1.7);
-- Result: 1
```

## GREATEST

指定された整数の中で最大のものを返します。

**構文**

```bash theme={null}
GREATEST(int1,int2,....)
```

**例**

```sql theme={null}
SELECT GREATEST(3,5,8,10,1)
-- Result: 10
```

## HEX

入力値に対応する 16 進数を返します。

**構文**

```sql theme={null}
HEX(value)
```

**パラメータ**

* **value**：16 進数に変換する文字列または数値。

**例**

```sql theme={null}
SELECT HEX(866849198);
-- Result: 33AB11AE

SELECT HEX('Sample Text');
-- Result: 53616D706C652054657874
```

## LEAST

指定された整数の中で最小のものを返します。

```
LEAST(int1,int2,....)
```

**例**

```sql theme={null}
SELECT LEAST(3,5,8,10,1)
-- Result: 1
```

## LOG

指定された float 式の自然対数を返します。

**構文**

```bash theme={null}
LOG( float_expression [, base ] )
```

**パラメータ**

* **float\_expression** float 式。
* **base** 対数の底を設定するオプションの整数引数。

**例**

```sql theme={null}
SELECT LOG(7.3890560);
-- Result: 1.99999998661119
```

## LOG10

指定された float 式の常用対数（底が 10）を返します。

**構文**

```bash theme={null}
LOG10( float_expression )
```

**パラメータ**

* **float\_expression** float 型の式。

**例**

```sql theme={null}
SELECT LOG10(10000);
-- Result: 4
```

## MOD

被除数を除数で割ったときの剰余に対応する整数値を返します。

**構文**

```bash theme={null}
MOD(dividend,divisor)
```

**パラメータ**

* **dividend** 剰余を求める対象の数値。
* **divisor** 剰余を求める際に被除数を割る数値。

**例**

```sql theme={null}
SELECT MOD(10,3);
-- Result: 1
```

## NEGATE

入力された実数の符号を反転した値を返します。

**構文**

```bash theme={null}
NEGATE(real_number)
```

**パラメータ**

* **real\_number** 符号を反転する対象の実数。

**例**

```sql theme={null}
SELECT NEGATE(10);
-- Result: -10

SELECT NEGATE(-12.4)
--Result: 12.4
```

## PI

円周率の定数値を返します。

**構文**

```bash theme={null}
PI()
```

**例**

```sql theme={null}
SELECT PI()
-- Result: 3.14159265358979
```

## POWER

指定された式を指定された累乗で計算した値を返します。

**構文**

```bash theme={null}
POWER(float_expression , y)
```

**パラメータ**

* **float\_expression** float 式。
* **y** float\_expression を累乗する指数。

**例**

```sql theme={null}
SELECT POWER(2, 10);
-- Result: 1024

SELECT POWER(2, -2);
-- Result: 0.25
```

## RADIANS

度数で指定された角度をラジアンで返します。

**構文**

```bash theme={null}
RADIANS(float_expression)
```

**パラメータ**

* **float\_expression** 角度を度数で表す float 式。

**例**

```sql theme={null}
SELECT RADIANS(180);
-- Result: 3.14159265358979
```

## RAND

0 から 1 までの擬似ランダムな float 値（両端を除く）を返します。

**構文**

```bash theme={null}
RAND( [ integer_seed ] )
```

**パラメータ**

* **seed** シード値を指定するオプションの整数式。シードを指定しない場合は、ランダムなシード値が割り当てられます。

**例**

```sql theme={null}
SELECT RAND();
-- This result may be different, since the seed is randomized
-- Result: 0.873159630165044

SELECT RAND(1);
-- This result will always be the same, since the seed is constant
-- Result: 0.248668584157093
```

## ROUND

指定された長さまたは精度に丸めた数値を返します。

**構文**

```bash theme={null}
ROUND( numeric_expression [ ,integer_length] [ ,function ] )
```

**パラメータ**

* **numeric\_expression** 数値データ型の式。
* **length** 数値式を丸めるオプションの精度。省略した場合、デフォルトでは最も近い整数に丸められます。
* **function** 実行する処理のオプションの種類。function パラメータを省略するか、値を 0（デフォルト）に指定した場合、numeric\_expression は丸められます。0 以外の値を指定した場合、numeric\_expression は切り捨てられます。

**例**

```sql theme={null}
SELECT ROUND(1.3, 0);
-- Result: 1

SELECT ROUND(1.55, 1);
-- Result: 1.6

SELECT ROUND(1.7, 0, 0);
-- Result: 2
SELECT ROUND(1.7, 0, 1);
-- Result: 1

SELECT ROUND (1.24);
-- Result: 1.0
```

## SIGN

指定された式の符号を、正の場合は 1、0 の場合は 0、負の場合は -1 として返します。

**構文**

```bash theme={null}
SIGN(numeric_expression)
```

**パラメータ**

* **numeric\_expression** bit データ型を除く、不定のデータ型の式。

**例**

```sql theme={null}
SELECT SIGN(0);
-- Result: 0

SELECT SIGN(10);
-- Result: 1

SELECT SIGN(-10);
-- Result: -1
```

## SIN

ラジアン単位の角度の三角関数サインを返します。

**構文**

```bash theme={null}
SIN(float_expression)
```

**パラメータ**

* **float\_expression** ラジアン単位の角度を指定する float 式。

**例**

```sql theme={null}
SELECT SIN(1);
-- Result: 0.841470984807897
```

## SQRT

指定された float 値の平方根を返します。

**構文**

```bash theme={null}
SQRT(float_expression)
```

**パラメータ**

* **float\_expression** float 型の式。

**例**

```sql theme={null}
SELECT SQRT(100);
-- Result: 10
```

## SQUARE

指定された float 値の 2 乗を返します。

**構文**

```bash theme={null}
SQUARE(float_expression)
```

**パラメータ**

* **float\_expression** float 型の式。

**例**

```sql theme={null}
SELECT SQUARE(10);
-- Result: 100

SELECT SQUARE(-10);
-- Result: 100
```

## TAN

入力式のタンジェントを返します。

**構文**

```bash theme={null}
TAN(float_expression)
```

**パラメータ**

* **float\_expression** float 型の式。

**例**

```sql theme={null}
SELECT TAN(1);
-- Result: 1.5574077246549
```

## TRUNC

指定された 10 進数を、指定された小数精度で切り捨てて返します。

**構文**

```bash theme={null}
TRUNC(decimal_number,precision)
```

**パラメータ**

* **decimal\_number** 切り捨てる対象の 10 進数値。
* **precision** 10 進数を切り捨てる小数点以下の桁数。

**例**

```sql theme={null}
SELECT TRUNC(10.3423,2);
-- Result: 10.34
```