SUBSTRING
Descrição
SUBSTRING
é uma função de linha que retorna os caracteres especificados de uma TEXT
com base na posição inicial e na posição final opcional fornecidas.Sintaxe
SUBSTRING
(search_string
,start
,end
)Valor de retorno
Retorna um valor por linha do tipo
TEXT
.Parâmetros de entrada
- search_string
- É obrigatório. O nome de um campo ou uma expressão do tipoTEXT(ou uma cadeia de caracteres literal).
- início
- É obrigatório. Um número inteiro que especifica onde os caracteres retornados começam (inclusive), com 0 sendo o primeiro caractere da cadeia de caracteres. Sestarté maior que o número de caracteres, uma cadeia de caracteres vazia é retornada. Seo valor de starté maior queo valor de end, uma cadeia de caracteres vazia é retornada.
- término
- Opcional. Um número inteiro positivo que especifica onde os caracteres retornados terminam (exclusivo), com o caracterefinalnão fazendo parte do valor de retorno. Seendé maior que o número de caracteres ou não é especificado, todo o valor da cadeia de caracteres (destart) é retornado.
Exemplos
Retornar a primeira letra do campo
de nome
:SUBSTRING([name], 0, 1)
Retornar somente os três dígitos do meio, sem hifens, de um número de telefone dos EUA no formato
123-456-7891
:SUBSTRING([us phone number], 4, 7)