# BYTES\_SUBSTRING

UTF-8 エンコードされたバイト表現のバイト単位のオフセットを使用して、入力値の部分文字列を返します。部分的な文字と無効な UTF-8 コードポイントは、結果から削除されます。

## 構文

クエリに `BYTES_SUBSTRING` 関数を組み込むには、次の構文を使用します。

```
BYTES_SUBSTRING(value, startIndex, endIndex)
```

## 引数

`BYTES_SUBSTRING` 関数には、次の引数が必要です。

* `value` 入力は、部分文字列関数を実行する文字列です。
* `startIndex` は `1` から始まり、文字列の最初の文字を含みます。
* `endIndex` は、`startIndex` の位置からではなく、文字列の最初の文字から数えます。

| 名前 | 型 | 説明 | 既定値 |
| --- | --- | --- | --- |
| value | string | 部分文字列関数を実行する入力値 |  |
| startIndex | int | バイト単位の開始インデックス (含む) |  |
| endIndex | int | バイト単位の終了インデックス (含まない) |  |

## 戻り値

`string` の値を返します。

***

## 例

次の例は、`startIndex` と `endIndex` の引数が `Output` の値にどのように影響するかを示しています。ここでは、`endIndex` の値は、`startIndex` の値に関係なく、`endIndex` が文字列の **1** 番目の位置から始まり、**10** 文字を含めるように機能することを示しています。

| value | startIndex | endIndex | 出力 |
| --- | --- | --- | --- |
| 'Hello World' | 1 | 10 | `Hello Worl` |
| 'Hello World' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Hello' | 1 | 10 | `Hello` |