# BYTES\_SUBSTRING

Retorna uma substring do valor de entrada, usando os deslocamentos em bytes da representação de byte codificada em UTF-8. Caracteres parciais e pontos de código UTF-8 inválidos são removidos do resultado.

## Sintaxe

Use a seguinte sintaxe para incluir a função `BYTES_SUBSTRING` em sua consulta:

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

## Argumentos

A função `BYTES_SUBSTRING` requer os seguintes argumentos:

* A entrada `value` é a string sobre a qual você deseja executar a função de substring.
* `startIndex` começa em `1` e inclui o primeiro caractere em sua string.
* `endIndex` conta a partir do primeiro caractere na string, não a partir da posição `startIndex`.

| Nome | Tipo | Descrição | Valor padrão |
| --- | --- | --- | --- |
| valor | caractere | O valor de entrada para executar a função de substring |  |
| startIndex | int | O índice inicial inclusivo em bytes |  |
| endIndex | int | O índice final exclusivo em bytes |  |

## Retorna

Retorna um valor `string`.

***

## Exemplos

O exemplo a seguir mostra como os argumentos `startIndex` e `endIndex` afetam o valor `Output`. Aqui, o valor `endIndex` demonstra que, independentemente do valor `startIndex`, o `endIndex` funciona a partir da posição **1** na string para incluir **10** caracteres.

| valor | startIndex | endIndex | Saída |
| --- | --- | --- | --- |
| '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` |