Pular para o conteúdo

Catálogo de fórmulas do ingestia BI

Nesta página (8)

Referência da linguagem analítica do ingestia (estilo DAX, em português). São 102 funções, com nome em pt-BR e aliases em inglês. Cada página é gerada automaticamente a partir do registro de funções do produto — se a função existe no produto, ela está aqui, e vice-versa (a doc e o produto são mantidos em sincronia).

Sintaxe brasileira#

  • Argumentos separados por ; (ponto e vírgula), não por vírgula.
  • Decimal com vírgula: 0,33. Milhar com ponto: 1.234,56.
  • Comparações: = <> > < >= <=. Concatenação de texto: &.
  • Variáveis: VAR nome = expressão; RETORNAR expressão.
  • Datas do fuso America/Sao_Paulo (HOJE(), AGORA()).

Sobre a compatibilidade com DAX#

A linguagem se INSPIRA no DAX e mantém os nomes em inglês como aliases, mas NÃO é DAX. Onde a semântica difere, a página da função marca explicitamente com DIFERE do DAX. Em geral: as agregações e a inteligência de tempo operam sobre as linhas do VISUAL (não sobre um modelo tabular com tabela de datas marcada), e o resultado vazio é um branco honesto, nunca um zero inventado.

Matemática (13)#

FunçãoO que fazAliasesDAX
ABSValor absoluto (sem sinal).—= DAX
ARREDArredonda o número com N casas decimais.round= DAX
TETOArredonda pra cima (inteiro).ceiling, ceil= DAX
PISOArredonda pra baixo (inteiro).floor= DAX
POTENCIABase elevada ao expoente.power, pow= DAX
RAIZRaiz quadrada.sqrt= DAX
EXPe elevado ao número.—= DAX
LNLogaritmo natural.—= DAX
LOGLogaritmo na base informada (padrão 10).—= DAX
MODResto da divisão.—= DAX
SINAL-1, 0 ou 1 conforme o sinal.sign= DAX
INTParte inteira (arredonda pra baixo).—= DAX
TRUNCARCorta as casas decimais (não arredonda).trunc= DAX

Estatística (10)#

FunçãoO que fazAliasesDAX
SOMASoma a coluna no grupo.sum= DAX
MEDIAMédia aritmética da coluna.average, avg= DAX
MEDIANAValor do meio (mediana).median= DAX
MINMenor valor da coluna.minimo= DAX
MAXMaior valor da coluna.maximo= DAX
CONTConta linhas (ou valores preenchidos da coluna).count≠ DAX
CONTDConta valores distintos da coluna.distinctcount, countd≠ DAX
DESVPADDesvio padrão amostral.stdev, stddev= DAX
VARVariância amostral.variance≠ DAX
PERCENTILPercentil da coluna (p entre 0 e 1).percentile= DAX

Lógica (8)#

FunçãoO que fazAliasesDAX
SESE(condição; então; senão?) — sem o 'senão' a resposta fica vazia.if= DAX
EVerdadeiro quando TODAS as condições valem.and≠ DAX
OUVerdadeiro quando ALGUMA condição vale.or≠ DAX
NAOInverte a condição.not= DAX
SEERRODevolve a alternativa quando a conta dá erro (ou fica vazia).iferror≠ DAX
ESCOLHERESCOLHER(valor; caso1; res1; ...; padrão?) — também aceita o nome CASO.switch, caso= DAX
COALESCE1º valor preenchido da lista.primeiro= DAX
EHVAZIO1 quando o valor está vazio.isblank= DAX

Texto (13)#

FunçãoO que fazAliasesDAX
CONCATENARJunta textos.concatenate, concat≠ DAX
ESQUERDAPrimeiros N caracteres.left= DAX
DIREITAÚltimos N caracteres.right= DAX
EXTTEXTOPedaço do texto a partir da posição (1 = 1º caractere).mid, substr= DAX
NUMCARACTQuantidade de caracteres.len, length= DAX
MAIUSCULATudo em maiúsculas.upper= DAX
MINUSCULATudo em minúsculas.lower= DAX
ARRUMARTira espaços sobrando.trim= DAX
SUBSTITUIRTroca todas as ocorrências de um trecho.substitute, replace≠ DAX
LOCALIZARPosição do trecho dentro do texto (0 = não achou).search, find≠ DAX
TEXTONúmero → texto (padrão pt-BR).format≠ DAX
VALORTexto → número (aceita 1.234,56).value= DAX
SEQUENCIASérie de números como TEXTO (de; até; passo?; separador?) — pra rótulo, legenda e subtítulo de cartão.generateseries, serie≠ DAX

Data e tempo (32)#

FunçãoO que fazAliasesDAX
HOJEData de hoje.today≠ DAX
AGORAData e hora agora.now≠ DAX
ANOAno da data.year= DAX
MESMês da data (1 a 12).month= DAX
DIADia do mês.day= DAX
TRIMESTRETrimestre (1 a 4).quarter= DAX
SEMANANúmero da semana no ano (semana começa no domingo).weeknum, week= DAX
DIASEMANADia da semana (1 = domingo … 7 = sábado).weekday, dayofweek= DAX
DATADIFDiferença entre duas datas na unidade escolhida.datediff≠ DAX
FIMMESÚltimo dia do mês, N meses à frente.eomonth= DAX
EDATEMesma data N meses à frente (ou atrás).datames= DAX
DATAMonta a data com ano; mês; dia.date= DAX
ACUM_ANOAcumulado do ano até o ponto atual (reinicia no início do ano do calendário do modelo — janeiro no civil, abril num fiscal abr–mar).totalytd, ytd≠ DAX
ACUM_TRIAcumulado do trimestre até o ponto atual.totalqtd, qtd≠ DAX
ACUM_MESAcumulado do mês até o ponto atual.totalmtd, mtd≠ DAX
MESMO_PERIODO_ANO_ANTERIORO mesmo intervalo de datas, um ano antes.sameperiodlastyear, spla≠ DAX
DESLOCAR_PERIODOA mesma medida N períodos antes/depois (unidade: d, m ou a).dateadd≠ DAX
MES_ANTERIORA medida no MÊS ANTERIOR INTEIRO (não o intervalo do grupo deslocado).previousmonth≠ DAX
ANO_ANTERIORA medida no ANO ANTERIOR INTEIRO (1º de janeiro a 31 de dezembro).previousyear≠ DAX
TRIMESTRE_ANTERIORA medida no TRIMESTRE ANTERIOR INTEIRO.previousquarter≠ DAX
PROXIMO_MESA medida no MÊS SEGUINTE INTEIRO (útil pra meta e previsão já lançadas).nextmonth≠ DAX
PROXIMO_ANOA medida no ANO SEGUINTE INTEIRO.nextyear≠ DAX
PERIODO_PARALELOA medida N períodos atrás/à frente, sempre no período INTEIRO (é o MES_ANTERIOR com o N que você escolhe).parallelperiod≠ DAX
DATAS_NO_PERIODODentro de CALCULAR: janela de N períodos a partir da data informada (N negativo volta no tempo). É o acumulado móvel — 3 meses, 12 meses, 7 dias.datesinperiod≠ DAX
SALDO_FINALO valor no ÚLTIMO dia COM LANÇAMENTO do período (não a soma). Período: "GRUPO" (padrão), "MES", "TRI" ou "ANO".closingbalance≠ DAX
SALDO_INICIALO valor no PRIMEIRO dia COM LANÇAMENTO do período (não a soma). Período: "GRUPO" (padrão), "MES", "TRI" ou "ANO".openingbalance≠ DAX
PRIMEIRA_DATAA menor data do grupo atual.firstdate≠ DAX
ULTIMA_DATAA maior data do grupo atual.lastdate≠ DAX
INICIO_MES1º dia do mês (período, no calendário fiscal/4-4-5) do grupo atual.startofmonth≠ DAX
FIM_MESÚltimo dia do mês (período, no calendário fiscal/4-4-5) do grupo atual.endofmonth≠ DAX
INICIO_ANO1º dia do ano (fiscal, quando configurado) do grupo atual.startofyear≠ DAX
FIM_ANOÚltimo dia do ano (fiscal, quando configurado) do grupo atual.endofyear≠ DAX

Contexto e filtro (26)#

FunçãoO que fazAliasesDAX
DIVIDIRDivisão sem erro: devolve a alternativa quando o divisor é zero.divide= DAX
PCT_TOTALParticipação do grupo no total do visual (0 a 1).pcttotalsem eq.
ACUMULADOSoma acumulada até o ponto atual do eixo.runningsem eq.
SUMTOTALTotal geral da coluna no visual inteiro.—sem eq.
TUDODentro de CALCULAR: ignora o filtro do grupo e usa o visual inteiro.all≠ DAX
FILTRARDentro de CALCULAR: mantém só as linhas em que a condição é verdadeira.filter≠ DAX
TUDO_EXCETODentro de CALCULAR: ignora o filtro do grupo MAS mantém a(s) coluna(s) informada(s).allexcept= DAX
REMOVER_FILTROSDentro de CALCULAR: apaga o filtro do grupo SÓ na(s) coluna(s) informada(s) e mantém o resto (é o contrário de TUDO_EXCETO).removefilters= DAX
MANTER_FILTROSDentro de CALCULAR: faz o modificador SOMAR ao filtro do grupo em vez de substituí-lo (o grupo continua valendo). Com uma condição simples não muda nada — ela já soma.keepfilters= DAX
TRATAR_COMODentro de CALCULAR: usa os valores que a 2ª coluna tem NO GRUPO ATUAL como filtro da 1ª — liga duas colunas sem relacionamento declarado. Aceita até 3 pares.treatas≠ DAX
ENTRE_DATASDentro de CALCULAR: troca o filtro de data pelo intervalo informado (ignora o período do grupo).datesbetween= DAX
CALCULARCalcula a expressão trocando o filtro: TUDO() ignora o grupo, FILTRAR() recorta.calculate≠ DAX
PRIMEIROS_NDentro de CALCULAR: fica só com as N maiores linhas pela expressão — ou com os N maiores grupos, se você informar a coluna. Empate na fronteira entra inteiro (pode passar de N).topn= DAX
CLASSIFICARPosição do grupo atual entre todos os grupos do visual pela medida (1 = maior). Empate divide a mesma posição.rankx, ranquear= DAX
PROCVValor de uma coluna na linha em que a busca casa (procura no visual inteiro). Aceita várias colunas de busca e um padrão no fim.lookupvalue, procurar= DAX
VALOR_SELECIONADOO valor da coluna quando o grupo tem um só; senão o padrão informado.selectedvalue= DAX
TEM_UM_VALOR1 quando a coluna tem um único valor no grupo atual.hasonevalue= DAX
ESTA_FILTRADO1 quando a coluna está recortada no grupo (tem menos valores que no visual inteiro).isfiltered≠ DAX
SOMAXCalcula a expressão em cada linha e SOMA os resultados. Aceita uma tabela FILTRAR(...) no 1º argumento.sumx≠ DAX
MEDIAXCalcula a expressão em cada linha e tira a MÉDIA. Aceita uma tabela FILTRAR(...) no 1º argumento.averagex≠ DAX
MINXMenor resultado da expressão entre as linhas. Aceita uma tabela FILTRAR(...) no 1º argumento.—≠ DAX
MAXXMaior resultado da expressão entre as linhas. Aceita uma tabela FILTRAR(...) no 1º argumento.—≠ DAX
CONTXQuantas linhas em que a expressão dá um valor (não vazio). Aceita uma tabela FILTRAR(...) no 1º argumento.countx≠ DAX
JUNTARXJunta num texto só o resultado da expressão em cada linha. Aceita uma tabela FILTRAR(...) no 1º argumento.concatenatex≠ DAX
CAMINHOCaminho da raiz até o item na hierarquia pai-filho, separado por "" (ex.: "33.1
ITEM_CAMINHONível N do caminho (1 = raiz). Com "FIM" no 3º argumento conta de trás pra frente (1 = o próprio item).pathitem= DAX

Referência gerada automaticamente a partir do registro de funções do produto e mantida em sincronia com o motor de fórmulas.

Links relacionados