Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

SUBSTRING

Mengembalikan bagian dari ekspresi karakter atau biner. SUBSTR adalah alias untuk SUBSTRING.

Lihat juga:
[SELECT] [ Tipe data ]


info

Untuk mengekstrak field dari objek JSON, gunakan fungsi JSON_EXTRACT.

Sintaksis​

SELECT SUBSTRING(expression, start[, length]) FROM <multipartIdentifier>;
SELECT SUBSTR(expression, start[, length]) FROM <multipartIdentifier>;

Argumen​

expression
String ASCII atau BLOB.

Jika expression adalah string, indeks karakter merujuk ke karakter UTF-8 yang sebenarnya. Jika expression adalah BLOB, indeks merujuk ke byte.

start
Bilangan bulat yang menyatakan karakter atau byte pertama dari bagian ekspresi input yang akan dikembalikan. Jika start negatif, karakter pertama substring ditemukan dengan menghitung dari kanan, bukan dari kiri.

Karakter paling kiri dari expression adalah nomor 1.

length
Nilai bilangan bulat opsional yang menyatakan panjang bagian yang akan dikembalikan setelah nilai start. Jika length dihilangkan, semua karakter hingga akhir string atau BLOB yang ditentukan oleh expression dikembalikan.

Jika length negatif, nilai absolut dari length yang digunakan.

Nilai yang dikembalikan​

Mengembalikan string atau nilai BLOB, bergantung pada tipe expression.


Contoh​

Mengembalikan n karakter pertama dari kolom​

SELECT SUBSTRING(name, 1, 5) as "first five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Memotong n karakter pertama dari kolom​

SELECT SUBSTR(name, 5) as "from char 5"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Mengembalikan n karakter terakhir dari kolom​

SELECT SUBSTRING(name, -5) as "last five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Untuk informasi selengkapnya, lihat https://www.sqlite.org/lang_corefunc.html#substr