Show Menu
TÓPICOS×

Lista de funções

Sobre funções

A ferramenta de edição de consulta permite usar funções avançadas para realizar filtragem complexa. Para fazer isso, a paleta de ferramentas contém o Expression elemento que pode ser usado no espaço de trabalho. Para mais informações sobre este elemento, ver uma seção Edição de expressão avançada específica.
Esse elemento permite que você insira suas 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 string
  • 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(<date>, <number>)
AdicionarHoras Adiciona um número de horas a uma data AddHours(<date>, <number>)
AdicionarMinutos Adiciona um número de minutos a uma data AddMinutes(<date>, <number>)
AdicionarMeses Adiciona um número de meses a uma data AddMonths(<date>, <number>)
AddSeconds Adiciona um número de segundos a uma data AddSeconds(<date>, <number>)
AdicionarAnos Adiciona um número de anos a uma data AddYears(<date>, <number>)
DateOnly Retorna somente a data (com a hora 00:00) DateOnly(<date>)
Dia Retorna o número que representa o dia da data Day(<date>)
DiaDoAno Returns a number representing the day in the year of the date DayOfYear(<date>)
Dias atrás Retorna a data atual menos n dias DaysAgo(<number>)
DiasAgoInt Retorna a data atual menos n dias (como um número inteiro aaaammdd) DaysAgoInt(<number>)
DiasDiferir Número de dias entre duas datas DaysDiff(<end date>, <start date>)
DiasAntigos Retorna a idade em dias de uma data. DaysOld(<date>)
GetDate Retorna a data atual do sistema do servidor. GetDate()
Hora Retorna a hora da data. Hour(<date>)
HorasDiff Retorna o número de horas entre duas datas HoursDiff(<end date>, <start date>)
LocalToUTC Converte uma data e hora locais em UTC LocalToUTC(<data>, <Fuso horário>)
Minuto Retorna os minutos da data Minute(<date>)
MinutosDiferença Retorna o número de minutos entre duas datas MinutesDiff(<end date>, <start date>)
Mês Retorna o número que representa o mês da data Month(<date>)
Meses atrás Retorna a data correspondente à data atual menos n meses MonthsAgo(<number>)
MesesDiferir Retorna o número de meses entre duas datas MonthsDiff(<end date>, <start date>)
MesesAntigo Retorna a idade em meses de uma data MonthsOld(<date>)
Second Retorna os segundos da data Second(<date>)
Mais antigo Retorna a data mais antiga Old(<Date>, <Date>)
SecondsDiff Retorna o número de segundos entre duas datas SecondsDiff(<end date>, <start date>)
SubDays Subtrai um número de dias a partir de uma data SubDays(<date>, <number>)
SubHours Subtrai um número de horas a partir de uma data SubHours(<date>, <number>)
Subminutos Subtrai um número de minutos de uma data SubMinutes(<date>, <number>)
Submeses Subtrai um número de meses a partir de uma data SubMonths(<date>, <number>)
Subsegundos Subtrai um número de segundos a partir de uma data SubSeconds(<date>, <number>)
Sub-anos Subtrai um número de anos a partir de uma data SubYears(<date>, <number>)
ToDate Converte uma data + hora em uma data ToDate(<date + time>)
DataHoraFinal Converte uma cadeia de caracteres em uma data + hora ToDateTime(<string>)
ToDateTimeWithTimezone Converte uma string em data + fuso horário. Exemplo: ToDateTimeWithTimezone ("2019-02-19 08:09:00", "Ásia/Teerã") ToDateTimeWithTimezone(<string>)
TruncDate Arredonda uma data e hora para o segundo mais próximo TruncDate(@lastModified, <number of seconds>)
TruncDateTZ Arredonda uma data e hora para uma determinada precisão expressa em segundos TruncDateTZ(<date>, <number of seconds>, <time zone>)
TruncQuarter Arredonda uma data para o trimestre TruncQuarter(<date>)
TruncTime Arredonda a parte de horário para cima até o próximo segundo TruncTime(<date>, <number of seconds>)
TruncWeek Arredonda uma data para a semana TruncWeek(<date>)
TruncYear Arredonda uma data + hora para 1º de janeiro do ano TruncYear(<date>)
DiaSemana Retorna o número que representa o dia na semana da data WeekDay(<date>)
Ano Retorna o número que representa o ano da data Year(<date>)
YearAnd Month Retorna o número que representa o ano e o mês da data. YearAndMonth(<date>)
AnosDiferir Retorna o número de anos entre as duas datas YearsDiff(<end date>, <start date>)
AnosAntigos Retorna a idade em anos de uma data YearsOld(<date>)

Geomarketing

As funções de geomarketing são usadas para manipular valores geográficos.
Nome Descrição Sintaxe
Distância Returns the distance in kilometers between two points defined by their longitude and latitude (expressed in degrees) 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(<number>)
Ceil Retorna o número inteiro mais baixo maior ou igual a um número Ceil(<number>)
Floor Retorna o maior inteiro maior ou igual a um número Floor(<number>)
Maior Retorna o maior número de dois números Greatest(<number 1>, <number 2>)
Mínimo Retorna o menor de dois números Least(<number 1>, <number 2>)
Mod Returns the remainder of the integer division from n1 by n2 Mod(<número 1>, <número 2>)
Porcentagem Retorna a proporção de dois números expressos como uma porcentagem Percent(<number 1>, <number 2>)
Aleatório Retorna o valor aleatório Random()
Round Arredonda um número para decimais n Round(<number>, <number of decimals>)
Assinar Retorna o sinal do número Sign(<number>)
ToDouble Converte um inteiro em um flutuante ToDouble(<number>)
ToInt64 Converte um flutuante em um inteiro de 64 bits ToInt64(<number>)
ToInteger Converte um flutuante em um inteiro ToInteger(<number>)
Trunc Corta o n1 para o decimal n2 Trunc(<n1>, <n2>)

Outros

Esta tabela contém as funções restantes disponíveis.
Nome Descrição Sintaxe
Caso Retorna o valor 1 se a condição for verificada. Caso contrário, retorna valor 2 Case(When(<condition>, <value 1>), Else(<value 2>))
ClearBit Exclui o Sinalizador no valor ClearBit(<identifier>, <flag>)
Coalescência Retorna o valor 2 se o valor 1 for zero ou nulo, caso contrário retorna o valor 1 Coalesce(<value 1>, <value 2>)
Decodificar Retorna o valor 3 é o valor 1 = valor 2; caso contrário, retorna 4 Decode(<value 1>, <value 2>, <value 3>, <value 4>)
Outro Retorna o valor 1 (só pode ser usado como parâmetro da função case) Else(<value 1>)
GetEmailDomain Extracts the domain from an email address GetEmailDomain(<value>)
GetMirrorURL Recupera o URL do servidor da mirror page GetMirrorURL(<value>)
Iif Retorna o valor 1 se a expressão for verdadeira, caso contrário retorna o valor 2 Iif(<condition>, <value 1>, <value 2>)
IsBitSet Indica se o Sinalizador está no valor IsBitSet(<identifier>, <flag>)
IsEmptyString Returns value 2 if the string is empty, otherwise returns value 3 IsEmptyString(<string>, <value 2>, <value 3>)
NoNull Retorna a cadeira de caracteres vazia se o argumento for NULL. NoNull(<value>)
RowId Retorna o número da linha. RowId
SetBit Força o Sinalizador no valor. SetBit(<identifier>, <flag>)
ToBoolean Converte um número em um booleano ToBoolean(<number>)
When Retorna o valor 1 se a expressão for verificada. Otherwise, returns value 2 (may only be used as a parameter of the case function) When(<condition>, <value 1>)
newUUID Retorna uma nova UUID. newUUID

Cadeia de caracteres

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(<string>, <string>)
AllNonNull3 Indica se todos os parâmetros são não nulos e não estão vazios AllNonNull3(<string>, <string>, <string>)
ASCII Retorna o valor ASCII do primeiro caractere na cadeia de caracteres Ascii(<string>)
Carro Retorna o caractere correspondente ao código ASCII 'n' Char(<number>)
Charindex Retorna a posição da cadeia de caracteres 2 na cadeia de caracteres 1 Charindex(<string>, <string>)
DataLength Retorna o número de caracteres em uma string DataLength(<String>)
GetLine Retorna a linha enésima (de 1 a n) da cadeia de caracteres GetLine(<string>)
IfEquals Retorna o terceiro parâmetro se os dois primeiros parâmetros forem iguais, caso contrário, retorna o último parâmetro IfEquals(<string>, <string>, <string>, <string>)
IsMemoNull Indica se o memorando passado como parâmetro é nulo IsMemoNull(<Memo>)
JuxtWords Cria as duas strings transmitidas como parâmetros. Um espaço é adicionado entre cada string no valor retornado. JuxtWords(<string>, <string>)
JuxtWords3 Cria as três strings transmitidas como parâmetros. Um espaço é adicionado entre cada string no valor retornado. JuxtWords3(<string>, <string>, <string>)
LPad Retorna a cadeira de caracteres concluída à esquerda LPad(<string>, <number>, <caractère>)
Esquerda Retorna os primeiros n caracteres da cadeira de caracteres Left(<string>, <number>)
Extensão Retorna o comprimento da string Length(<string>)
Lower Retorna a cadeira de caracteres em minúsculas Lower(<string>)
Ltrim Remove espaços à esquerda da cadeira de caracteres Ltrim(<string>)
Md5Digest Retorna uma representação hexadecimal da chave MD5 de uma cadeira de caracteres Md5Digest(<string>)
MemoContains Especifica se o memorando contém a cadeira de caracteres aprovada como um parâmetro MemoContains(<memo>, <string>)
RPad Retorna a cadeira de caracteres concluída à direita RPad(<string>, <number>, <character>)
Substituir 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(<String>, <String>, <String>)
Direita Retorna os últimos n caracteres da cadeira de caracteres Right(<string>)
Rtrim Remove espaços à direita da cadeira de caracteres Rtrim(<string>)
Sha256Digest Calcula o hash SHA256 padrão para uma determinada string UTF8 Sha256Digest(<String>)
Sha384Digest Calcula o hash SHA384 padrão para uma determinada string UTF8 Sha384Digest(<String>)
Sha512Digest Calcula o hash SHA512 padrão para uma determinada string UTF8 Sha512Digest(<String>)
Inteligente Retorna a cadeira de caracteres com a primeira letra de cada palavra em maiúsculas Smart(<string>)
Substring Extracts the sub-string starting at character n1 of the string and with a length of n2 Substring(<string>, <offset>, <length>)
ToIntlString Converte o número em uma cadeira de caracteres ToIntlString(<número>)
ToString Converte o número em uma cadeira de caracteres ToString(<number>)
Upper Retorna a cadeira de caracteres em maiúsculas Upper(<string>)
VirtualLink Retorna a chave externa de um link passado como um parâmetro se os outros dois parâmetros forem iguais VirtualLink(<number>, <number>, <number>)
VirtualLinkStr Retorna a chave externa (texto) de um link passado como um parâmetro se os outros dois parâmetros forem iguais VirtualLinkStr(<string>, <number>, <number>)
encrypt_aescbcDecrypt Descriptografa um valor criptografado no formato HEX com 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) encrypt_aescbcDecrypt(<String>, <String>, <String>)
encrypt_aescbcEncrypt Criptografa usando o algoritmo AES (modo de bloco CBC) uma sequência 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 aleatorizado com o mesmo comprimento da chave. encrypt_aescbcEncrypt(<String>, <String>, <String>) Por exemplo: encrypt_aescbcEncrypt(johndoe@example.com, " \x0123456789ABCDEF0123456789ABCDEF ", " \x0123456789ABCDEFFEDCBA 9876543210 ")

Agregados

As funções de agregação só estão disponíveis ao adicionar dados adicionais da Query atividade de um fluxo de trabalho.
As funções agregadas são usadas para executar cálculos em um conjunto de valores.
Nome Descrição Sintaxe
Média , Média Retorna a média em uma coluna numérica. Avg(<value>)
Contagem , Contagem (exceto NULL) Counts the non-null values in a column. Count(<value>)
ContarTodos , Contar todos Conta todos os valores (incluindo valores nulos e duplicatas). CountAll()
Contagem distinta , Contagem distinta Conta os valores distintos não nulos em uma coluna. Countdistinct(<value>)
Máx , máx Retorna o valor máximo em uma coluna numérica, de string ou de data. Max(<value>)
Mín , Mín Retorna o valor mínimo em uma coluna numérica, de string ou de data. Min(<value>)
Soma , Soma Retorna a soma dos valores em uma coluna numérica. Sum(<value>)

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(<value 1>)
OrderBy Classifica o resultado dentro da partição OrderBy(<value 1>)
PartitionBy Partições do resultado de um query em uma tabela PartitionBy(<value 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 é suportada para MySQL RowNum(PartitionBy(<value 1>), OrderBy(<value 1>))