# SUBSTRING

指定された文字列内の、指定された位置から始まる部分文字列を抽出します。

これは[`SUBSTR`](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/string/substr.htm)関数のエイリアスです。

## 構文

```
SUBSTRING(STRING, START [, LENGTH])
```

## 引数

#### STRING

型: `string`

部分文字列を抽出する対象の文字列。

#### START

型: `integer`

部分文字列の開始インデックス。

位置は `1` から始まります。負の開始位置は、文字列の末尾を基準とした相対位置として解釈されます。

#### LENGTH

型: `integer`

(オプション) 部分文字列の長さ。

省略した場合、開始位置 `START` 以降の文字列の残りの部分が返されます。

## 戻り値

型: `string`

`STRING` から、開始位置 `START` から長さ `LENGTH` の部分文字列を返します。

***

## 例

| STRING | START | LENGTH | 出力 |
| --- | --- | --- | --- |
| Hello World | 1 | 5 | Hello |
| Hello World | 0 | 4 | `''` |
| Hello World | -5 | 5 | 世界 |
| Hello World | 12 | 4 | `''` |
| Hello World | -12 | 4 | `''` |
| Hello World | 2 | 3 | ell |
| Hello World | 3 | -2 | `''` |
| Hello World | 2 | 14 | ello World |
| Hello World | 2 |  | ello World |
| Hello World | -3 | 2 | rl |
| `null` | -3 | 2 | `null` |