Fungsi matematika - Hologres

Topik ini menjelaskan fungsi-fungsi yang didukung oleh Hologres dan memberikan contoh penggunaannya.

null

Untuk informasi lebih lanjut tentang cara menggunakan fungsi string yang kompatibel dengan PostgreSQL, lihat Fungsi Matematika dan Operator.

Tipe	Fungsi	Deskripsi
Fungsi matematika umum	ABS	Mengembalikan nilai absolut dari sebuah angka.
	CBRT	Mengembalikan akar pangkat tiga dari sebuah angka.
	CEIL	Membulatkan angka ke bilangan bulat terdekat ke atas.
	CEILING	Membulatkan angka ke bilangan bulat terdekat ke atas.
	DEGREES	Mengonversi radian ke derajat yang setara.
	EXP	Mengembalikan hasil konstanta dipangkatkan ke angka tertentu.
	FLOOR	Membulatkan angka ke bilangan bulat terdekat ke bawah.
	LN	Mengembalikan logaritma natural dari sebuah angka.
	LOG	Mengembalikan logaritma basis 10 dari sebuah angka.
	MOD	Mengembalikan sisa pembagian sebuah angka dengan angka x.
	PI	Mengembalikan nilai konstanta π.
	POWER	Mengembalikan hasil a dipangkatkan ke b.
	RADIANS	Mengonversi sudut dalam derajat ke radian yang setara.
	RANDOM	Mengembalikan angka acak.
	ROUND	Membulatkan angka ke bilangan bulat terdekat atau ke angka dengan jumlah tempat desimal tetap.
	SIGN	Mengembalikan tanda dari sebuah angka.
	SQRT	Mengembalikan akar kuadrat dari sebuah angka.
	TRUNC	Memotong angka menjadi bilangan bulat atau angka dengan jumlah tempat desimal tetap.
	WIDTH_BUCKET	Membagi kumpulan data menjadi interval dengan lebar sama dan mengembalikan nomor interval di mana operand jatuh.
Fungsi trigonometri	ACOS	Mengembalikan arccosinus dari sebuah angka.
	ASIN	Mengembalikan arcsinus dari sebuah angka.
	ATAN	Mengembalikan arctangent dari sebuah angka.
	ATAN2	Mengembalikan arctangent dari `y dibagi x`.
	COS	Mengembalikan kosinus dari sebuah angka.
	COT	Mengembalikan kotangen dari sebuah angka.
	SIN	Mengembalikan sinus dari sebuah angka.
	TAN	Mengembalikan tangen dari sebuah angka.

Fungsi matematika umum

ABS

Mengembalikan nilai absolut dari sebuah angka.
```
ABS(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa INT, BIGINT, REAL, DOUBLE PRECISION, NUMERIC, atau DECIMAL.
Nilai Kembali:
Nilai bertipe INT, BIGINT, REAL, DOUBLE PRECISION, NUMERIC, atau DECIMAL dikembalikan.
Contoh:
```
SELECT ABS(-17.4);
```
Hasil berikut dikembalikan:
```
 abs
-----
 17.4
```

CBRT

Mengembalikan akar pangkat tiga dari sebuah angka.
```
CBRT(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT CBRT(9);

Hasil berikut dikembalikan:

      cbrt
-----------------
 2.0800838230519

CEIL

Membulatkan angka ke bilangan bulat terdekat ke atas.
```
CEIL(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.
Contoh:
```
SELECT CEIL(9.2);
```
Hasil berikut dikembalikan:
```
 ceil
------
   10
```

CEILING

Membulatkan angka ke bilangan bulat terdekat ke atas.
```
CEILING(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.
Contoh:
```
SELECT CEILING(9.2);
```
Hasil berikut dikembalikan:
```
 ceil
------
   10
```

DEGREES

Mengonversi radian ke derajat yang setara.
```
DEGREES(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT DEGREES(3.2);

Hasil berikut dikembalikan:

      degrees
--------------
183.34649444186343

EXP

Mengembalikan hasil konstanta dipangkatkan ke angka tertentu.
```
EXP(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.

Contoh:

SELECT EXP(1);

Hasil berikut dikembalikan:

             exp
----------------
2.718281828459045

FLOOR

Membulatkan angka ke bilangan bulat terdekat ke bawah.
```
FLOOR(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.
Contoh:
```
SELECT FLOOR(3.8);
```
Hasil berikut dikembalikan:
```
 floor
------
     3
```

LN

Mengembalikan logaritma natural dari sebuah angka.
```
LN(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.

Contoh:

SELECT LN(3.8);

Hasil berikut dikembalikan:

            ln
----------------
1.3350010667323401

LOG

Mengembalikan logaritma basis 10 dari sebuah angka.
```
LOG(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.
Contoh:
```
SELECT LOG(100);
```
Hasil berikut dikembalikan:
```
 log
-----
   2
```

MOD

Mengembalikan sisa pembagian sebuah angka dengan angka x.
```
MOD(num, x)
```
Parameter:
- num: wajib. Tipe parameter harus NUMERIC.
- x: wajib. Tipe parameter harus NUMERIC.
Nilai Kembali:
Nilai bertipe NUMERIC dikembalikan.
Contoh:
```
SELECT MOD(9,4);
```
Hasil berikut dikembalikan:
```
  mod
-----
    1
```

PI

Mengembalikan nilai konstanta π.
```
PI()
```
Nilai Kembali:
Nilai konstanta π dikembalikan.

Contoh:

SELECT PI();

Hasil berikut dikembalikan:

        pi
------------------
 3.14159265358979

POWER

Mengembalikan hasil a dipangkatkan ke b.
```
POWER(a, b)
```
Parameter:
- a: wajib. Tipe parameter harus DOUBLE PRECISION.
- b: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT POWER(9, 3);

Hasil berikut dikembalikan:

 power
-------
   729

RADIANS

Mengonversi sudut dalam derajat ke radian yang setara.
```
RADIANS(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT RADIANS(45);

Hasil berikut dikembalikan:

       radians
-------------------
 0.785398163397448

RANDOM

Mengembalikan angka acak.
```
RANDOM()
```
Nilai Kembali:
Angka acak bertipe DOUBLE PRECISION dikembalikan. Nilai valid: [0.0, 1.0).

Contoh:

SELECT RANDOM();

Hasil berikut dikembalikan:

      random
-------------------
 0.377819478977472

ROUND

Deskripsi:
- Membulatkan angka ke bilangan bulat terdekat.
```
ROUND(num)
```
- Membulatkan angka ke angka dengan s tempat desimal.
```
ROUND(num1, s)
```
Parameter:
- num: wajib. Jika satu parameter input digunakan, nilai parameter dapat berupa DOUBLE PRECISION atau NUMERIC. Jika dua parameter input digunakan, hanya nilai NUMERIC yang didukung.
- s: opsional. Nilai parameter harus bertipe INT.
Nilai Kembali:
Nilai dengan tipe data yang sama dengan parameter input num dikembalikan.

Contoh:

SELECT ROUND(42.4);

Hasil berikut dikembalikan:

 round
-------
    42

SIGN

Mengembalikan tanda dari sebuah angka.
```
SIGN(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Jika nilai parameter lebih besar dari 0, nilai 1 dikembalikan. Jika nilai parameter kurang dari 0, nilai -1 dikembalikan. Jika nilai parameter adalah 0, nilai 0 dikembalikan.
Contoh:
```
SELECT SIGN(-8.4);
```
Hasil berikut dikembalikan:
```
 sign
------
   -1
```

SQRT

Mengembalikan akar kuadrat dari sebuah angka.
```
SQRT(num)
```
Parameter:
num: wajib. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION atau NUMERIC dikembalikan.

Contoh:

SELECT SQRT(2);

Hasil berikut dikembalikan:

      sqrt
-----------------
 1.4142135623731

TRUNC

Deskripsi:
- Memotong angka menjadi bilangan bulat.
```
TRUNC(num)
```
- Memotong angka menjadi angka dengan s tempat desimal.
```
TRUNC(num, s)
```
Parameter:
- num: wajib. Tipe parameter harus NUMERIC.
- s: opsional. Tipe parameter harus INT.
Nilai Kembali:
Nilai bertipe NUMERIC dikembalikan.

Contoh:

Contoh 1:

SELECT TRUNC(2.456);

Hasil berikut dikembalikan:

 trunc
-------
     2

Contoh 2:

SELECT TRUNC(2.4564, 2);

Hasil berikut dikembalikan:

 trunc
-------
  2.45

WIDTH_BUCKET

Membagi kumpulan data menjadi interval dengan lebar sama dan mengembalikan nomor interval di mana operand jatuh.
```
WIDTH_BUCKET(value, start, end, num_buckets)
```
Parameter:
value: wajib. Nomor interval di mana operand jatuh. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
start: wajib. Nilai awal interval. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
end: wajib. Nilai akhir interval. Tipe parameter dapat berupa DOUBLE PRECISION atau NUMERIC.
num_buckets: wajib. Jumlah interval (bucket) yang akan dibagi. Tipe parameter harus INT.
Nilai Kembali:
Nilai bertipe INT dikembalikan.

Contoh:

--Data berkisar dari 0 hingga 100 jatuh ke dalam 5 bucket. 45 jatuh pada bucket ketiga dengan nilai awal 40 dan nilai akhir 60. 
SELECT WIDTH_BUCKET(45, 0, 100, 5);

Hasil berikut dikembalikan:

 width_bucket
--------------
            3

Fungsi trigonometri

ACOS

Mengembalikan arccosinus dari sebuah angka.
```
ACOS(num)
```
Parameter:
num: wajib. Tipe parameter harus NUMERIC. Nilai valid: [-1,1].
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT ACOS(-1);

Hasil berikut dikembalikan:

       acos
------------------
 3.14159265358979

ASIN

Mengembalikan arcsinus dari sebuah angka.
```
ASIN(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION. Nilai valid: [-1,1].
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT ASIN(-1);

Hasil berikut dikembalikan:

       asin
------------------
 -1.5707963267949

ATAN

Mengembalikan arctangent dari sebuah angka.
```
ATAN(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT ATAN(2);

Hasil berikut dikembalikan:

       atan
------------------
 1.10714871779409

ATAN2

Mengembalikan arctangent dari y dibagi x.
```
ATAN2(y, x);
```
Parameter:
- y: wajib. Tipe parameter harus DOUBLE PRECISION.
- x: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT ATAN2(4, 2);

Hasil berikut dikembalikan:

      atan2
------------------
 1.10714871779409

COS

Mengembalikan kosinus dari sebuah angka.
```
COS(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT COS(2);

Hasil berikut dikembalikan:

        cos
--------------------
 -0.416146836547142

COT

Mengembalikan kotangen dari sebuah angka.
```
COT(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT COT(2);

Hasil berikut dikembalikan:

        cot
--------------------
 -0.457657554360286

SIN

Mengembalikan sinus dari sebuah angka.
```
SIN(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT SIN(2);

Hasil berikut dikembalikan:

        sin
-------------------
 0.909297426825682

TAN

Mengembalikan tangen dari sebuah angka.
```
TAN(num)
```
Parameter:
num: wajib. Tipe parameter harus DOUBLE PRECISION.
Nilai Kembali:
Nilai bertipe DOUBLE PRECISION dikembalikan.

Contoh:

SELECT TAN(2);

Hasil berikut dikembalikan:

        tan
-------------------
 -2.18503986326152