Funções de caractere

Utilize uma função de caractere permite manipular strings de caracteres em uma fórmula. A entrada é uma coluna do conjunto de dados e as funções são aplicadas ao conteúdo da célula.

Tabela 1: Funções de caractere

Função

Sintaxe

Descrição

<matchExpr> como <pattern>

  • matchExpr: A expressão de string para pesquisar
  • pattern: A constante da string do padrão a ser pesquisada para

Determina se uma sequência específica de caracteres corresponde a um padrão definido. A pesquisa não diferencia letras maiúsculas de minúsculas.

O padrão pode incluir caracteres regulares e os seguintes caracteres especiais:
  • "_" corresponde a um único caractere
  • "%" corresponde o zero a muitos caracteres
Antes de poder utilizar um caractere especial como um caractere regular, você deve isolá-lo, utilizando uma barra invertida ("\").
Nota "[", "^", "-" e "]" estão reservados para um uso futuro.
Por exemplo:
"Hiking is fun" like "H% is _un"
retorna true

Concatenate(str1, str2)

  • str1: primeira string
  • str2: segunda string

Concatena duas strings em uma só.

O operador + também pode concatenar strings.

Por exemplo:
Concatenate("Mr", "Brown")
retorna "MrBrown"

Contain(whereStr, whatStr)

  • whereStr: string em que uma pesquisa é conduzida
  • whatStr: substring que é o objeto de pesquisa

Retorna ocorrências de uma string em outra string. A pesquisa não diferencia letras maiúsculas de minúsculas.

Por exemplo:
Contain("Cats are grey", "aRe")
retorna true

ExceptFirstWord(str, sep)

  • str: string de entrada
  • sep: um separador

Retorna uma cópia de uma string, sem a primeira palavra.

Por exemplo:
ExceptFirstWord("Level 3, Standford Street", ", ")
retorna "Standford Street"

ExceptLastWord(str, sep)

  • str: string de entrada
  • sep: um separador

Retorna uma cópia de uma string, sem a última palavra.

Por exemplo:
ExceptLastWord("james.brown@company.com", "@")
retorna "james.brown"

FirstWord(str, sep)

  • str: string de entrada
  • sep: um separador

Retorna a primeira palavra da string.

Por exemplo:
FirstWord("Senior Developer", " ")
retorna "Senior"

LastWord(str, sep)

  • str: string de entrada
  • sep: um separador

Retorna a última palavra de uma string.

Por exemplo:
LastWord("Red/Purple", "/")
retorna "Purple"

Length(str)

str: string de entrada

Retorna o comprimento de uma string.

Por exemplo:
Length("How long")
retorna 8

LowerCase(str)

str: string de entrada

Retorna uma cópia de uma string, com todos os caracteres convertidos em letras minúsculas.

Por exemplo:
LowerCase("GOOD JOB")
retorna "good job"

Lpad(str, length, pad)

  • str: string de entrada
  • length: comprimento esperado
  • pad: Sequência de caracteres a ser adicionada

Retorna uma cópia de uma string, preenchida com caracteres iniciais para atingir o comprimento total especificado.

Por exemplo:
Lpad("Incomplete field", 20, "#")
retorna "####Incomplete field"

Replace(str, target, replacement)

  • str: string de entrada
  • target: String a ser substituída
  • replacement: Valor da string a ser inserido

Retorna uma string, com todas as ocorrências de uma string especificada substituídas por outra string especificada.

Por exemplo:
Replace("hyperthermia", "ert", "ot")
retorna "hypothermia"

Rpad(str, length, pad)

  • str: string de entrada
  • length: comprimento esperado
  • pad: Sequência de caracteres a ser adicionada

Retorna uma cópia de uma string, preenchida com caracteres finais para atingir o comprimento total especificado.

Por exemplo:
Rpad("Incomplete field", 20, "#")
retorna "Incomplete field####"

SubString(str, start)

  • str: String a partir da qual uma substring é calculada
  • start: Posição inicial na substring de entrada

Retorna uma substring de uma string.

Por exemplo:
SubString("Wong", 3)
retorna "ng"

SubString(str, start, length)

  • str: String a partir da qual uma substring é calculada
  • start: Posição inicial na substring de entrada
  • length: Comprimento da substring a retornar

Retorna uma substring de uma string.

Por exemplo:
SubString("Wong", 2, 2)
retorna "on"

ToText(param)

param: O parâmetro a ser convertido

Converte um parâmetro em string. Todos os parâmetros são válidos e números são truncados a zero casas decimais.

Trim(str, toTrim)

  • str: string de entrada
  • toTrim: Caractere a ser removido

Retorna uma cópia da string, sem as repetições inicial e final de um caractere. Esta função diferencia letras maiúsculas e minúsculas.

Por exemplo:
Trim("Aurora", "a")
retorna "Auror"

TrimLeft(str, toTrim)

  • str: string de entrada
  • toTrim: Caractere a ser removido

Retorna uma cópia da string, sem a ocorrência inicial de um caractere. Esta função diferencia letras maiúsculas e minúsculas.

Por exemplo:
TrimLeft("Above", "A")
retorna "bove"

TrimRight(str, toTrim)

  • str: string de entrada
  • toTrim: Caractere a ser removido

Retorna uma cópia de uma string, sem as repetições finais de um caractere. Esta função diferencia letras maiúsculas e minúsculas.

Por exemplo:
TrimRight("Laura", "a")
retorna "Laur"

UpperCase(str)

str: string de entrada

Retorna uma cópia de uma string, com todos os caracteres convertidos em letras maiúsculas.

Por exemplo:
UpperCase("Little Boy")
retorna "LITTLE BOY"

ToDate(string, format)

O formato da data é uma combinação dos tokens reservados a seguir, separados delimitadores:
  • d ou dd: Dia do mês (1-31)
  • M ou MM: Mês do ano (1-12)
  • y ou yy: Ano abreviado sem o século (00-99)

    yyyy: Ano com o século (1956, 2012, 2014 e assim por diante)

Todas as outras sequências são consideradas delimitadores.
  • string: String de entrada a ser convertida
  • format: constante de string de formato da data

Converte uma string de entrada de um conjunto de dados em uma data com formato específico quando as datas em uma coluna de uma fonte de dados original estão em formato de string.

Por exemplo:
ToDate(Obj, 'yyyy/dd/MM')
converte uma string no formato yyyy/dd/MM em uma data:
Tabela 2: Exemplo da função Trim(str, toTrim): Trim ({Name},"a")

Nome

String recortada

Aurora

Auror

Auror

Auror

auror

uror

aurora

uror

uror

uror

Esta fórmula retorna "Auror": Trim("Aurora", "a").