Watch the 7.3 Webinar On-Demand
This new release brings updates to Universal Storage, query optimization, and usability that you won’t want to miss.

SUBSTRING

Extracts a range of characters from a string.

Syntax

SUBSTRING(str, start, len)
SUBSTR(str, start, len)

Arguments

  • str: any string or binary object
  • start: the one-indexed position to start at. If negative, counts from the end.
  • len: the number of characters to extract

Return Type

String

Remarks

  • In SUBSTR or SUBSTRING, the starting index point of a string is 1 (not 0).

Examples

In the following example, the starting index 3 represents the third character in the string, because the index starts from 1.

SELECT SUBSTRING('1234567890', 3, 3);
****
+-------------------------------+
| SUBSTRING('1234567890', 3, 3) |
+-------------------------------+
| 345                           |
+-------------------------------+

In the following example, the substring is returned from the end, because the starting index is a negative number.

SELECT SUBSTRING('1234567890', -3, 3);
****
+--------------------------------+
| SUBSTRING('1234567890', -3, 3) |
+--------------------------------+
| 890                            |
+--------------------------------+

Related Topics