跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

SUBSTRING

傳回字元或二進位運算式的一部分。SUBSTR 是 SUBSTRING 的別名。

另請參閱:
[SELECT] [ 資料型別 ]


資訊

若要從 JSON 物件擷取欄位,請使用 JSON_EXTRACT 函式。

語法​

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

引數​

expression
ASCII 字串或 BLOB。

如果 expression 是字串,則字元索引指的是實際的 UTF-8 字元。如果 expression 是 BLOB,則索引指的是位元組。

start
整數,表示要傳回之輸入運算式子序列的第一個字元或位元組。如果 start 為負數,則子字串的第一個字元會從右側而非左側開始計算。

expression 最左側的字元編號為 1。

length
選用的整數值,表示從 start 值起要傳回的子序列長度。如果省略 length,則傳回 expression 所指定之字串或 BLOB 直到結尾的所有字元。

如果 length 為負數,則使用 length 的絕對值。

傳回值​

依 expression 的型別傳回字串或 BLOB 值。


範例​

從資料行傳回前 n 個字元​

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

從資料行截去前 n 個字元​

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

從資料行傳回最後 n 個字元​

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

如需詳細資訊,請參閱 https://www.sqlite.org/lang_corefunc.html#substr。