Prefácio
A Linguagem de Transformação
Constantes
Operadores
Variáveis
Datas
Funções
- Categorias de função
  - Funções de agregação
  - Funções de agregação e Nulls
    - Condições do Filtro
  - Funções binárias
  - Funções de caractere
  - Funções de conversão
  - Funções de Limpeza de Dados
  - Funções de data
  - Funções de codificação
  - Funções financeiras
  - Funções numéricas
  - Funções científicas
  - Funções especiais
  - Funções de string
  - Funções de teste
  - Funções variáveis
  - Funções de janela
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ASCII
- AVG
- BINARY_COMPARE
- BINARY_CONCAT
- BINARY_LENGTH
- BINARY_SECTION
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DEC_HEX
- DECODE
- DECOMPRESS
- EBCDIC_ISO88591
- ENC_BASE64
- ENC_HEX
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- LOOKUP
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Datas)
- MAX (Números)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Datas)
- MIN (Números)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Datas)
- ROUND (Números)
- RPAD
- RTRIM
- SETCOUNTVARIABLE
- SET_DATE_PART
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TIME_RANGE
- TO_BIGINT
- TO_CHAR (Datas)
- TO_CHAR (Números)
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Datas)
- TRUNC (Números)
- UPPER
- VARIANCE
Criação de funções personalizadas
Referência de API da Função Personalizada

Referência de Linguagem de Transformação

10.5
- 10.4.0

Anterior Avançar

SUBSTR

Retorna uma parte de uma string. A função SUBSTR conta todos os caracteres, inclusive espaços em branco, iniciando pelo começo da string.

Sintaxe

SUBSTR( string, start [,length] )

A tabela a seguir descreve os argumentos para este comando:

Argumento	Requerido/ Opcional	Descrição
string	Requerido	Deve ser uma string de caractere. Passa os valores que você deseja pesquisar. Você pode inserir qualquer expressão de transformação válida. Se você passar um valor numérico, a função o converterá em uma string de caractere.
início	Requerido	Deve ser um inteiro. A posição na string onde você deseja começar a contagem. Você pode inserir qualquer expressão de transformação válida. Se a posição inicial for um número positivo, SUBSTR localizará a posição inicial contando a partir do começo da strings. Se a posição inicial for um número negativo, SUBSTR localizará a posição inicial contando a partir do final da string. Se a posição inicial for 0, SUBSTR pesquisará a partir do primeiro caractere da string.
length	Opcional	Deve ser um inteiro maior que 0. O número de caracteres que você deseja que SUBSTR retorne. Você pode inserir qualquer expressão de transformação válida. Se você omitir o argumento length, SUBSTR retornará todos os caracteres da posição inicial ao fim da strings. Se você transmitir um inteiro negativo ou 0, a função retornará uma string vazia. Se você passar um decimal, a função o arredondará para o valor inteiro mais próximo.

Valor de Retorno

String.

String vazia se você passar um valor de comprimento negativo ou 0.

NULL se um valor transmitido para a função for NULL.

Exemplos

As seguintes expressões retornam o código de área de cada linha na porta Telefone:

SUBSTR( PHONE, 0, 3 )

PHONE	RETURN VALUE
809-555-0269	809
357-687-6708	357
NULL	NULL

SUBSTR( PHONE, 1, 3 )

PHONE	RETURN VALUE
809-555-3915	809
357-687-6708	357
NULL	NULL

As seguintes expressões retornam o número de telefone sem o código de área de cada linha na porta Telefone:

SUBSTR( PHONE, 5, 8 )

PHONE	RETURN VALUE
808-555-0269	555-0269
809-555-3915	555-3915
357-687-6708	687-6708
NULL	NULL

Você também pode passar um valor inicial negativo para retornar o número de telefone de cada linha na porta Telefone. A expressão ainda lê a string de origem da esquerda para a direita ao retornar o resultado do argumento comprimento
:

SUBSTR( PHONE, -8, 3 )

PHONE	RETURN VALUE
808-555-0269	555
809-555-3915	555
357-687-6708	687
NULL	NULL

Você pode aninhar INSTR no argumento início
ou comprimento
para pesquisar uma string específica e retornar sua posição.

A expressão a seguir avalia uma string, começando a partir do final da string. A expressão encontra o último espaço (extrema direita) na string e, em seguida, retorna todos os caracteres precedentes:

SUBSTR( CUST_NAME,1,INSTR( CUST_NAME,' ' ,-1,1 ) - 1 )

CUST_NAME	RETURN VALUE
PATRICIA JONES	PATRICIA
MARY ELLEN SHAH	MARY ELLEN

A seguinte expressão remove o caractere '#' de uma string:

SUBSTR( CUST_ID, 1, INSTR(CUST_ID, '#')-1 ) || SUBSTR( CUST_ID, INSTR(CUST_ID, '#')+1 )

Quando o argumento length
for maior que a string, SUBSTR retornará todos os caracteres da posição inicial até o fim da string. Considere o seguinte exemplo: