Fungsi Numerik SQLite: ROUND, ABS, CEIL, dan FLOOR

SQLite Punya Lebih Banyak Fungsi Matematika dari yang Kamu Kira

SQLite terkenal minimalis, tapi SQLite membawa satu set lengkap fungsi numerik: pembulatan, nilai absolut, pembulatan ke atas dan ke bawah, pangkat, akar, logaritma, trigonometri, dan bilangan acak. Sebagian besar fungsi matematika ditambahkan di SQLite 3.35 (2021), jadi instalasi apa pun yang cukup modern, seperti yang dibundel bersama Python, Node, pendahulu WebSQL di browsermu, atau CLI resminya, sudah langsung bisa memakainya.

Ini contoh singkatnya sebelum kita membahas lebih dalam:

SELECT
    ROUND(3.14159, 2)   AS rounded,
    ABS(-42)            AS absolute,
    CEIL(2.1)           AS ceiling,
    FLOOR(2.9)          AS floor_val,
    POWER(2, 10)        AS two_to_ten,
    SQRT(144)           AS root;

Enam fungsi, satu baris hasil. Sisa halaman ini membahas kegunaan setiap kelompok fungsi dan jebakan yang perlu kamu ketahui.

ROUND: Fungsi yang Paling Sering Kamu Pakai

ROUND(value, digits) membulatkan ke sejumlah angka desimal tertentu. Argumen kedua opsional: jika tidak ditulis, kamu mendapat pembulatan ke integer terdekat (tapi tetap dalam bentuk nilai floating-point):

SELECT
    ROUND(3.14159)       AS no_digits,
    ROUND(3.14159, 2)    AS two_places,
    ROUND(3.14159, 4)    AS four_places,
    ROUND(2.5)           AS half_up,
    ROUND(-2.5)          AS half_down;

Beberapa hal yang perlu diperhatikan:

• ROUND(3.14159) mengembalikan 3.0, bukan 3. Jika kamu ingin integer, pakai CAST(ROUND(x) AS INTEGER) atau cukup CAST(x AS INTEGER) untuk memotong.
• SQLite memakai aturan "bulatkan setengah menjauhi nol": 2.5 dibulatkan menjadi 3, -2.5 dibulatkan menjadi -3. Beberapa database memakai banker's rounding (bulatkan setengah ke bilangan genap); SQLite tidak.
• Argumen digits boleh negatif: ROUND(1234.5, -2) membulatkan ke kelipatan 100 terdekat, menghasilkan 1200.

Dalam praktiknya, yang paling sering kamu tulis adalah ROUND(price, 2) untuk menampilkan nilai uang.

ROUND vs CAST: Keduanya Berbeda

Orang sering memakai CAST(x AS INTEGER) padahal maksudnya membulatkan, lalu kena batunya:

SELECT
    CAST(2.9 AS INTEGER)   AS cast_truncates,
    ROUND(2.9)             AS round_rounds,
    CAST(-2.9 AS INTEGER)  AS cast_negative,
    ROUND(-2.9)            AS round_negative;

CAST memotong ke arah nol: bagian pecahannya dibuang begitu saja. ROUND membulatkan ke integer terdekat. Untuk 2.9, selisih keduanya satu angka penuh. Pilih yang perilakunya memang kamu inginkan.

ABS, SIGN, dan Tanda Sebuah Bilangan

ABS(x) mengembalikan nilai absolut. SIGN(x) mengembalikan -1, 0, atau 1 sesuai tanda bilangannya:

SELECT
    ABS(-17)    AS abs_neg,
    ABS(17)     AS abs_pos,
    ABS(0)      AS abs_zero,
    SIGN(-17)   AS sign_neg,
    SIGN(0)     AS sign_zero,
    SIGN(42.5)  AS sign_pos;

ABS adalah andalannya, praktis untuk query "seberapa jauh jarak dua nilai ini". SIGN lebih jarang dipakai, tapi berguna saat kamu ingin mengelompokkan baris berdasarkan arahnya (debit vs kredit, untung vs rugi) tanpa CASE eksplisit.

CEIL, FLOOR, dan TRUNC

Fungsi-fungsi ini memberimu nilai mirip integer tanpa membulatkan ke yang terdekat. CEIL selalu naik, FLOOR selalu turun, TRUNC selalu menuju nol:

SELECT
    CEIL(2.1)    AS ceil_pos,
    CEIL(-2.1)   AS ceil_neg,
    FLOOR(2.9)   AS floor_pos,
    FLOOR(-2.9)  AS floor_neg,
    TRUNC(2.9)   AS trunc_pos,
    TRUNC(-2.9)  AS trunc_neg;

Perhatikan kasus negatifnya. FLOOR(-2.9) adalah -3 (lebih jauh dari nol), tapi TRUNC(-2.9) adalah -2 (menuju nol). Untuk bilangan negatif, FLOOR dan TRUNC memberi hasil berbeda, dan salah memilih adalah bug selisih satu yang klasik.

CEILING adalah alias untuk CEIL. Pakai ejaan mana pun yang menurutmu lebih enak dibaca.

Pembagian Integer Adalah Jebakan Sebenarnya

Ini bukan fungsi, melainkan operator /, tapi lebih sering menjebak pemula daripada fungsi matematika mana pun:

SELECT
    5 / 2           AS int_div,
    5 / 2.0         AS real_div,
    5.0 / 2         AS also_real,
    CAST(5 AS REAL) / 2  AS explicit_cast;

Jika kedua sisi integer, SQLite melakukan pembagian integer dan memotong hasilnya. Begitu salah satu sisi bertipe REAL, seluruh ekspresinya menjadi real. Solusinya adalah memastikan setidaknya satu operan berupa float, entah dengan menulis 2.0 alih-alih 2, atau dengan cast.

Jebakan ini paling terasa dengan referensi kolom: total_cents / 100 mengembalikan integer. total_cents / 100.0 mengembalikan nilai dolar yang sebenarnya kamu inginkan.

MOD dan Operator %

MOD(x, y) mengembalikan sisa dari x / y. Operator % melakukan hal yang sama:

SELECT
    MOD(17, 5)   AS mod_func,
    17 % 5       AS mod_op,
    MOD(-17, 5)  AS mod_neg,
    MOD(17, 0)   AS mod_zero;

MOD(17, 5) dan 17 % 5 sama-sama mengembalikan 2. Modulo dengan nol menghasilkan NULL di SQLite, tanpa memunculkan error, dan ini tidak biasa dibandingkan kebanyakan bahasa. Jika itu penting bagimu, cek pembaginya dulu atau bungkus pemanggilannya dengan CASE WHEN y = 0 THEN ... END.

Bentuk fungsi dan operatornya bisa saling menggantikan. Kebanyakan orang memakai % karena lebih pendek.

POWER, SQRT, EXP, LOG

Untuk pangkat dan akar:

SELECT
    POWER(2, 10)    AS two_to_the_ten,
    POW(2, 0.5)     AS sqrt_via_power,
    SQRT(2)         AS sqrt_two,
    EXP(1)          AS e,
    LOG(100)        AS log10_100,
    LN(EXP(1))      AS ln_of_e;

Beberapa catatan yang sering menjebak:

• POW adalah alias untuk POWER.
• LOG(x) di SQLite berbasis 10. LN(x) adalah logaritma natural. LOG(b, x) dengan dua argumen adalah logaritma berbasis b. (Ini berbeda dari banyak bahasa yang log-nya adalah logaritma natural; konvensi SQL yang dipakai di sini.)
• SQRT dari bilangan negatif menghasilkan NULL, bukan error.
• POWER(0, 0) mengembalikan 1 sesuai konvensi.

Fungsi-fungsi ini berguna untuk bunga majemuk, normalisasi ke desibel, menghitung jarak, dan di mana pun matematika geometris atau eksponensial muncul.

RANDOM dan RANDOMBLOB

RANDOM() mengembalikan integer 64-bit bertanda, di mana saja dalam seluruh rentangnya:

SELECT
    RANDOM()                          AS raw_random,
    ABS(RANDOM()) % 100               AS zero_to_99,
    ABS(RANDOM()) % 100 + 1           AS one_to_100,
    ABS(RANDOM() / 9223372036854775807.0) AS unit_interval;

Untuk mendapatkan bilangan dalam sebuah rentang, bungkus dengan ABS (karena RANDOM() bertanda) lalu pakai %. Untuk mendapatkan bilangan real antara 0 dan 1, bagi dengan integer 64-bit terbesar. SQLite tidak punya RAND() bawaan yang mengembalikan 0 sampai 1, jadi kamu membuatnya sendiri.

RANDOMBLOB(n) mengembalikan n byte data acak, berguna untuk membuat token sesi atau data uji. Gabungkan dengan HEX() untuk mendapat string yang bisa dicetak:

SELECT HEX(RANDOMBLOB(8)) AS token;

Setiap pemanggilan menghasilkan nilai baru. Jangan harap RANDOM() mengembalikan angka yang sama dua kali di baris yang sama; bahkan di dalam satu ekspresi, setiap pemanggilan berdiri sendiri.

Menggabungkan Semuanya

Contoh kecil: menghitung jarak dan membulatkan harga untuk tabel produk.

CREATE TABLE products (id INTEGER, name TEXT, price_cents INTEGER, weight_g REAL);
INSERT INTO products VALUES
    (1, 'Mug',     1299, 350.5),
    (2, 'Notebook', 850, 180.2),
    (3, 'Pen',      199,  12.0);

SELECT
    name,
    ROUND(price_cents / 100.0, 2)  AS price_dollars,
    CEIL(weight_g / 100)           AS weight_buckets_100g,
    POWER(weight_g, 0.5)           AS sqrt_weight
FROM products;

price_cents / 100.0 adalah bagian kuncinya: .0 itu membuat pembagiannya menjadi real, lalu ROUND merapikannya menjadi dua angka desimal. Tanpanya, 1299 / 100 akan memberimu 12, bukan 12.99.

Selanjutnya: Tanggal dan Waktu

Fungsi numerik menangani matematika. Tanggal dan waktu butuh perangkatnya sendiri: SQLite menyimpannya sebagai teks, real, atau integer, dan memberimu sekumpulan fungsi yang kecil tapi mumpuni untuk mem-parse, memformat, dan berhitung dengannya. Itulah yang dibahas berikutnya.