# BYTES\_SUBSTRING

返回输入值的子字符串，使用 UTF-8 编码字节表示形式的字节偏移量。不完整的字符和无效的 UTF-8 码点将从结果中移除。

## 语法

使用以下语法在您的查询中包含 `BYTES_SUBSTRING` 函数：

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

## 参数

`BYTES_SUBSTRING` 函数需要以下参数：

* `value` 输入是您要对其执行子字符串函数的字符串。
* `startIndex` 从 `1` 开始，并包含字符串中的第一个字符。
* `endIndex` 从字符串中的第一个字符开始计数，而不是从 `startIndex` 位置开始。

| 名称 | 类型 | 描述 | 默认值 |
| --- | --- | --- | --- |
| 值 | 字符串 | 要对其执行子字符串函数的输入值 |  |
| startIndex | int | 包含的起始字节索引 |  |
| endIndex | int | 不包含的结束字节索引 |  |

## 返回

返回一个 `string` 值。

***

## 示例

以下示例展示了 `startIndex` 和 `endIndex` 参数如何影响 `Output` 值。此处，`endIndex` 值表明，无论 `startIndex` 值如何，`endIndex` 都从字符串中的位置 **1** 开始，包含 **10** 个字符。

| 值 | startIndex | endIndex | 输出 |
| --- | --- | --- | --- |
| '你好世界' | 1 | 10 | `Hello Worl` |
| '你好世界' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Hello' | 1 | 10 | `Hello` |