# SUBSTRING

> Fungsi SUBSTRING di StackQL (alias SUBSTR): mengembalikan bagian dari string atau nilai biner berdasarkan posisi awal dan panjang.

Source: https://stackql.io/id/language-spec/functions/string/substring

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

Lihat juga:  
[[` SELECT `]](/language-spec/select) [[ Tipe data ]](/language-spec/data-types)

* * * 

:::info

Untuk mengekstrak field dari objek JSON, gunakan fungsi [**JSON_EXTRACT**](/language-spec/functions/json/json_extract).

:::

## Sintaksis

```sql
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

```sql
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

```sql
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

```sql
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](https://www.sqlite.org/lang_corefunc.html#substr)
