

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Substring
<a name="substring-function"></a>

`substring` retorna os caracteres de uma string, começando pelo local especificado pelo argumento *start* e prosseguindo para o número de caracteres especificado pelos argumentos *length*. 

## Sintaxe
<a name="substring-function-syntax"></a>

```
substring(expression, start, length)
```

## Argumentos
<a name="substring-function-arguments"></a>

 *expressão*   
Uma expressão pode ser o nome de um campo que usa o tipo de dados string, como **address1**, um valor literal, como **'Unknown'**, ou outra função, como `substring(field_name,1,5)`.

 *start*   
A localização de caractere a partir da qual começar. *start* é inclusivo, de forma que o caractere na posição inicial é o primeiro caractere no valor retornado. O valor mínimo de *start* é 1. 

 *length*   
O número de caracteres adicionais a serem incluídos após *start*. *length* inclui *start*, por isso o último caractere retornado será (*length* - 1) após o caractere inicial.

## Tipo de retorno
<a name="substring-function-return-type"></a>

String

## Exemplo
<a name="substring-function-example"></a>

O exemplo a seguir retorna do 13º ao 19º caracteres de uma string. O início da string é o índice 1, então você começa a contar no primeiro caractere.

```
substring('Fantasy and Science Fiction',13,7)
```

O valor a seguir é retornado.

```
Science
```