Show Menu
TÓPICOS×

Lista de funções

Sobre funções

A ferramenta de edição de query permite usar funções avançadas para fazer filtragens complexas. Para fazer isso, a paleta de ferramentas contém o elemento Expression que pode ser usado no espaço de trabalho. Informações adicionais sobre esse elemento estão detalhadas em uma seção específica .
Esse elemento permite inserir as condições manualmente. Aqui, você pode usar as funções definidas nas seções a seguir.
Vários tipos de função estão disponíveis, dependendo dos resultados desejados e dos tipos de dados manipulados:
  • Datas
  • Geomarketing
  • Valores numéricos
  • Outras funções
  • Agregados
  • Manipulação de strings
  • Classificação

Datas

As funções de data são usadas para manipular valores de data ou hora.
Nome Descrição Sintaxe
AddDays Adiciona um número de dias a uma data AddDays(<data>, <número>)
AddHours Adiciona um número de horas a uma data AddHours(<data>, <número>)
AddMinutes Adiciona um número de minutos a uma data AddMinutes(<data>, <número>)
AddMonths Adiciona um número de meses a uma data AddMonths(<data>, <número>)
AddSeconds Adiciona um número de segundos a uma data AddSeconds(<data>, <número>)
AddYears Adiciona um número de anos a uma data AddYears(<data>, <número>)
DateOnly Retorna somente a data (com a hora 00:00) DateOnly(<data>)
Day Retorna o número que representa o dia da data Day(<data>)
DayOfYear Retorna o número que representa o dia no ano da data DayOfYear(<data>)
DaysAgo Retorna a data atual menos n dias DaysAgo(<número>)
DaysAgoInt Retorna a data atual menos n dias (como um número inteiro yyyymmdd) DaysAgoInt(<número>)
DaysDiff Número de dias entre duas datas DaysDiff(<data final>, <data inicial>)
DaysOld Retorna a idade em dias de uma data. DaysOld(<data>)
GetDate Retorna a data atual do sistema do servidor. GetDate()
Hour Retorna a hora da data. Hour(<data>)
HoursDiff Retorna o número de horas entre duas datas HoursDiff(<data final>, <data inicial>)
LocalToUTC Converte uma data e hora locais em UTC LocalToUTC(<data>, <Fuso horário>)
Minute Retorna os minutos da data Minute(<data>)
MinutesDiff Retorna o número de minutos entre duas datas MinutesDiff(<data final>, <data inicial>)
Month Retorna o número que representa o mês da data Month(<data>)
MonthsAgo Retorna a data correspondente à data atual menos n meses MonthsAgo(<número>)
MonthsDiff Retorna o número de meses entre duas datas MonthsDiff(<data final>, <data inicial>)
MonthsOld Retorna a idade em meses de uma data MonthsOld(<data>)
Second Retorna os segundos da data Second(<data>)
Oldest Retorna a data mais antiga Oldest(<Data>, <Data>)
SecondsDiff Retorna o número de segundos entre duas datas SecondsDiff(<data final>, <data inicial>)
SubDays Subtrai um número de dias a partir de uma data SubDays(<data>, <número>)
SubHours Subtrai um número de horas a partir de uma data SubHours(<data>, <número>)
SubMinutes Subtrai um número de minutos de uma data SubMinutes(<data>, <número>)
SubMonths Subtrai um número de meses a partir de uma data SubMonths(<data>, <número>)
SubSeconds Subtrai um número de segundos a partir de uma data SubSeconds(<data>, <número>)
SubYears Subtrai um número de anos a partir de uma data SubYears(<data>, <número>)
ToDate Converte uma data + hora em uma data ToDate(<data + hora>)
ToDateTime Converte uma cadeia de caracteres em uma data + hora ToDateTime(<cadeia de caracteres>)
ToDateTimeWithTimezone Converte uma string em uma data + fuso horário. Exemplo: ToDateTimeWithTimezone ("2019-02-19 08:09:00", "Asia/Tehran") ToDateTimeWithTimezone(<cadeia de caracteres>)
TruncDate Arredonda uma data e hora para o segundo mais próximo TruncDate(@lastModified, <número de segundos>)
TruncDateTZ Arredonda uma data e hora para uma determinada precisão expressa em segundos TruncDateTZ(<data>, <número de segundos>, <fuso horário>)
TruncQuarter Arredonda uma data para o trimestre TruncQuarter(<data>)
TruncTime Arredonda a parte de horário para cima até o próximo segundo TruncTime(<data>, <número de segundos>)
TruncWeek Arredonda uma data para a semana TruncWeek(<data>)
TruncYear Arredonda uma data + hora para 1º de janeiro do ano TruncYear(<data>)
WeekDay Retorna o número que representa o dia na semana da data WeekDay(<data>)
Year Retorna o número que representa o ano da data Year(<data>)
YearAnd Month Retorna o número que representa o ano e o mês da data. YearAndMonth(<data>)
YearsDiff Retorna o número de anos entre as duas datas YearsDiff(<data final>, <data inicial>)
YearsOld Retorna a idade em anos de uma data YearsOld(<data>)

Geomarketing

As funções de geomarketing são usadas para manipular valores geográficos.
Nome Descrição Sintaxe
Distance Retorna a distância em quilômetros entre dois pontos definidos por sua longitude e latitude (expressa em graus) Distance(<Longitude A>, <Latitude A>, <Longitude B>, <Latitude B>)

Numerical

As funções de valor numérico são usadas para converter texto em números.
Nome Descrição Sintaxe
Abs Retorna o valor absoluto de um número Abs(<número>)
Ceil Retorna o número inteiro mais baixo maior ou igual a um número Ceil(<número>)
Floor Retorna o maior inteiro menor que ou igual a um número Floor(<número>)
Greatest Retorna o maior número de dois números Greatest(<número 1>, <número 2>)
Least Retorna o menor de dois números Least(<número 1>, <número 2>)
Mod Retorna o resto da divisão do número inteiro de n1 por n2 Mod(<número 1>, <número 2>)
Percent Retorna a proporção de dois números expressos como uma porcentagem Percent(<número 1>, <número 2>)
Random Retorna o valor aleatório Random()
Round Arredonda um número para decimais n Round(<número>, <número de decimais>)
Sign Retorna o sinal do número Sign(<número>)
ToDouble Converte um inteiro em um flutuante ToDouble(<número>)
ToInt64 Converte um flutuante em um inteiro de 64 bits ToInt64(<número>)
ToInteger Converte um flutuante em um inteiro ToInteger(<número>)
Trunc Corta o n1 para o decimal n2 Trunc(<n1>, <n2>)

Outros

Essa tabela contém as funções restantes disponíveis.
Nome Descrição Sintaxe
Case Retorna o valor 1 quando a condição é verificada. Caso contrário, retorna o valor 2 Case(When(<condição>, <valor 1>), Else(<valor 2>))
ClearBit Exclui o Sinalizador no valor ClearBit(<identificador>, <sinalizador>)
Coalesce Retorna o valor 2 se o valor 1 for zero ou nulo, caso contrário retorna o valor 1 Coalesce(<valor 1>, <valor 2>)
Decode Retorna o valor 3 quando valor 1 = valor 2; caso contrário, retorna 4 Decode(<valor 1>, <valor 2>, <valor 3>, <valor 4>)
Else Retorna o valor 1 (só pode ser usado como parâmetro da função case) Else(<valor 1>)
GetEmailDomain Extrai o domínio de um endereço de email GetEmailDomain(<valor>)
GetMirrorURL Recupera o URL do servidor da mirror page GetMirrorURL(<valor>)
Iif Retorna o valor 1 quando a expressão é verdadeira; caso contrário, retorna o valor 2 Iif(<condição>, <valor 1>, <valor 2>)
IsBitSet Indica se o Sinalizador está no valor IsBitSet(<identificador>, <sinalizador>)
IsEmptyString Retorna o valor 2 quando a string está vazia; caso contrário, retorna o valor 3 IsEmptyString(<cadeia de caracteres>, <valor 2>, <valor 3>)
NoNull Retorna a cadeia de caracteres vazia se o argumento for NULL. NoNull(<valor>)
RowId Retorna o número da linha. RowId
SetBit Força o Sinalizador no valor. SetBit(<identificador>, <sinalizador>)
ToBoolean Converte um número em um booleano ToBoolean(<número>)
When Retorna o valor 1 quando a expressão é verificada. Caso contrário, retorna o valor 2 (só pode ser usado como parâmetro da função case) When(<condição>, <valor 1>)
newUUID Retorna um novo UUID. newUUID

String

As funções de string são usadas para manipular um conjunto de strings.
Nome Descrição Sintaxe
AllNonNull2 Indica se todos os parâmetros são não nulos e não estão vazios AllNonNull2(<cadeia de caracteres>, <cadeia de caracteres>)
AllNonNull3 Indica se todos os parâmetros são não nulos e não estão vazios AllNonNull3(cadeia de caracteres>, <cadeia de caracteres>, <cadeia de caracteres>)
ASCII Retorna o valor ASCII do primeiro caractere na cadeia de caracteres Ascii(<cadeia de caracteres>)
Char Retorna o caractere correspondente ao código ASCII 'n' Char(<número>)
Charindex Retorna a posição da cadeia de caracteres 2 na cadeia de caracteres 1 Charindex(<cadeia de caracteres>, <cadeia de caracteres>)
DataLength Retorna o número de caracteres em uma string DataLength(<Cadeia de caracteres>)
GetLine Retorna a linha enésima (de 1 a n) da cadeia de caracteres GetLine(<cadeia de caracteres>)
IfEquals Retorna o terceiro parâmetro quando os dois primeiros parâmetros são iguais; caso contrário, retorna o último parâmetro IfEquals(<cadeia de caracteres>, <cadeia de caracteres>, <cadeia de caracteres>, <cadeia de caracteres>)
IsMemoNull Indica se o memorando passado como parâmetro é nulo IsMemoNull(<Memorando>)
JuxtWords Concatena as duas strings transmitidas como parâmetros. Um espaço é adicionado entre cada string no valor retornado. JuxtWords(<cadeia de caracteres>, <cadeia de caracteres>)
JuxtWords3 Concatena as três strings transmitidas como parâmetros. Um espaço é adicionado entre cada string no valor retornado. JuxtWords3(<cadeia de caracteres>, <cadeia de caracteres>, <cadeia de caracteres>)
LPad Retorna a cadeira de caracteres concluída à esquerda LPad(<cadeia de caracteres>, <número>, <caractere>)
Left Retorna os primeiros n caracteres da cadeira de caracteres Left(<cadeia de caracteres>, <número>)
Length Retorna o tamanho da string Length(<cadeia de caracteres>)
Lower Retorna a cadeira de caracteres em minúsculas Lower(<cadeia de caracteres>)
Ltrim Remove espaços à esquerda da cadeira de caracteres Ltrim(<cadeia de caracteres>)
Md5Digest Retorna uma representação hexadecimal da chave MD5 de uma cadeira de caracteres Md5Digest(<cadeia de caracteres>)
MemoContains Especifica se o memorando contém a cadeira de caracteres aprovada como um parâmetro MemoContains(<memorando>, <cadeia de caracteres>)
RPad Retorna a cadeira de caracteres concluída à direita RPad(<cadeia de caracteres>, <número>, <caractere>)
Replace Substitui todas as ocorrências de um valor de string especificado (segundo parâmetro) por outro valor de string (terceiro parâmetro) em uma string (primeiro parâmetro) Replace(<Cadeia de caracteres>, <Cadeia de caracteres>, <Cadeia de caracteres>)
Right Retorna os últimos n caracteres da cadeia de caracteres Right(<cadeia de caracteres>)
Rtrim Remove espaços à direita da cadeira de caracteres Rtrim(<cadeia de caracteres>)
Sha256Digest Calcula o hash SHA256 padrão para uma determinada string UTF8 Sha256Digest(<Cadeia de caracteres>)
Sha384Digest Calcula o hash SHA384 padrão para uma determinada string UTF8 Sha384Digest(<Cadeia de caracteres>)
Sha512Digest Calcula o hash SHA512 padrão para uma determinada string UTF8 Sha512Digest(<Cadeia de caracteres>)
Smart Retorna a cadeira de caracteres com a primeira letra de cada palavra em maiúsculas Smart(<cadeia de caracteres>)
Substring Extrai a substring, começando no caractere n1 da string e com comprimento de n2 Substring(<cadeia de caracteres>, <deslocamento>, <comprimento>)
ToIntlString Converte o número em uma cadeia de caracteres ToIntlString(<número>)
ToString Converte o número em uma cadeia de caracteres ToString(<número>)
Upper Retorna a cadeia de caracteres em maiúsculas Upper(<cadeia de caracteres>)
VirtualLink Retorna a chave externa de um link passado como um parâmetro se os outros dois parâmetros forem iguais VirtualLink(<número>, <número>, <número>)
VirtualLinkStr Retorna a chave externa (texto) de um link passado como um parâmetro se os outros dois parâmetros forem iguais VirtualLinkStr(<cadeia de caracteres>, <número>, <número>)
encryption_aescbcDecrypt Descriptografa um valor criptografado no formato HEX com o prefixo " x " (primeiro parâmetro) usando uma chave no formato HEX (segundo parâmetro) e um vetor de inicialização no formato HEX (terceiro parâmetro) encryption_aescbcDecrypt(<Cadeia de caracteres>, <Cadeia de caracteres>, <Cadeia de caracteres>)
encryption_aescbcEncrypt Criptografa usando o algoritmo AES (modo de bloco CBC) uma string de caracteres (primeiro parâmetro) com uma chave (segundo parâmetro) e um vetor de inicialização (terceiro parâmetro). A chave e o vetor de inicialização devem ser fornecidos em uma representação hexadecimal (começando com \x ). O resultado será hexadecimal sem o \x . Observe que o tamanho da chave pode ser de 128 bits, 192 bits, 256 bits (16, 24, 32 caracteres hexadecimais), mas recomendamos que você use 256 bits e um IV aleatório com o mesmo comprimento da chave. encryption_aescbcEncrypt(<Cadeia de caracteres>, <Cadeia de caracteres>, <Cadeia de caracteres>) Por exemplo: encryption_aescbcEncrypt(johndoe@example.com, " \x0123456789ABCDEF0123456789ABCDEF ", " \x0123456789ABCDEFFEDCBA9876543210 ")

Agregados

As funções de agregação só estão disponíveis ao adicionar dados adicionais atividade Query de um workflow.
As funções de agregação são usadas para realizar cálculos em um conjunto de valores.
Nome Descrição Sintaxe
Avg , Average Retorna a média em uma coluna numérica. Avg(<valor>)
Count , Contagem (exceto NULL) Conta os valores não nulos em uma coluna. Count(<valor>)
CountAll , Contar todos Conta todos os valores (incluindo valores e duplicados nulos). CountAll()
Countdistinct , Distinct count Conta os valores não nulos e distintos de uma coluna. Countdistinct(<valor>)
Max , Máx Retorna o valor máximo de uma coluna numérica, de string ou de data. Max(<valor>)
Min , Mín Retorna o valor mínimo de uma coluna numérica, de string ou de data. Min(<valor>)
Sum , Soma Retorna a soma dos valores em uma coluna numérica. Sum(<valor>)

Representação

As funções de representação são usadas para ordenar valores.
Nome Descrição Sintaxe
Desc Aplica uma classificação decrescente Desc(<valor 1>)
OrderBy Classifica o resultado dentro da partição OrderBy(<valor 1>)
PartitionBy Partições do resultado de um query em uma tabela PartitionBy(<valor 1>)
RowNum Gera um número de linha com base na partição da tabela e em uma sequência de classificação. Esta função não tem suporte para o MySQL RowNum(PartitionBy(<valor 1>), OrderBy(<valor 1>))