Referência de funções do Explore

Ao criar seus atributos e métricas personalizados, você usará muitas funções para ajudar em comparações, cálculos e manipulações das suas informações de negócios.

O Explore dispõe de várias funções para ajudar você a trabalhar com datas, cadeias de caracteres, cálculos e muito mais. Use este artigo como referência para descobrir as funções disponíveis e como usá-las.

Este artigo contém os seguintes tópicos:

• Introdução
• Operadores matemáticos básicos
• Funções lógicas
• Funções de atributo
• Funções de tag
• Funções de texto
• Funções de regex
• Funções de data
• Funções numéricas
• Funções trigonométricas
• Funções da URL
• Funções do JSON
• Funções de criptografia

Introdução

Você pode pesquisar e selecionar funções ao criar um atributo ou uma métrica calculada padrão. Na janela de edição de fórmulas, comece digitando o nome de uma função ou clicando em Adicionar em Funções e escolhendo a função da lista.

Depois de adicionada à fórmula, a função será exibida com valores padrão. Substitua esses valores com outros que você queira usar na sua fórmula. Neste exemplo, você quer retornar somente seus tickets com linhas de assunto que comecem com "[Marcado]".

1. No menu Cálculos (), clique em Atributo calculado padrão.
2. Dê um nome a seu atributo calculado. Este exemplo usa Assunto começa com [Marcado].
3. Em Funções, clique em Adicionar.
4. Na janela da fórmula, digite IF.
5. Em Funções, clique em Adicionar.
6. Pesquise por LEFTPART. Use a caixa de pesquisa e clique em Filtrar para definir os valores até a categoria Texto ou role pela lista até encontrar a função desejada.
7. Ao lado de LEFTPART, clique em +.
8. Você verá a fórmula IF LEFTPART(_texto,_número). Altere o parâmetro _texto para o atributo “Assunto do ticket”. Destaque _texto e escolha Assunto do ticket do menu Campos ou altere a fórmula manualmente para adicionar o atributo.

   Agora, a fórmula será IF LEFTPART([Assunto do ticket],_número)

9. Altere “texto_número” para o número de caracteres que você deseja comparar. [Marcado] tem nove caracteres, portanto, insira 9.

   Agora, a fórmula lerá IF LEFTPART([Assunto do ticket],9)

10. Por fim, adicione a condição que estamos procurando, neste caso, o texto "Marcado". A fórmula final será:

    IF LEFTPART([Assunto do ticket],9)="Marcado" THEN [ID do ticket] ENDIF

    

Agora, ao usar esse atributo no seu relatório, ele retornará somente os tickets com linha de assunto que comecem com “[Marcado]”

Para obter ajuda e exemplos, consulte Criação de fórmulas do Explore.

Operadores matemáticos básicos

Além das funções acima, você pode usar operadores matemáticos básicos para realizar cálculos e conectar texto:

Operador	Descrição
+	Adiciona dois valores numéricos ou une duas cadeias de caracteres.
-	Subtrai um valor do outro.
*	Multiplica dois valores.
/	Divide um valor pelo outro.
=	Testa se um valor é igual ao outro.
!=	Testa se um valor não é igual ao outro.
>	Testa se o primeiro valor é maior que o valor seguinte (x>y)
<	Testa se o primeiro valor é menor que o valor seguinte (x<y)
>=	Testa se o primeiro valor é maior ou igual ao valor seguinte (x>=y)
<=	Testa se o primeiro valor é menor ou igual ao valor seguinte (x<=y)
%	Calcula o módulo (ou resto) depois de dividir um valor pelo outro. Exemplo: 5%2 retorna 1, 20%3 retorna 2

Funções lógicas

Estas funções dão grande flexibilidade à análise e à apresentação das suas informações da forma que você quiser.

Função	Descrição
Expressão condicional IF THEN ELSE	Permite que você avalie valores lógicos. Formato: IF (condição) THEN (valor se for verdadeiro) ELSE (valor se for falso) ENDIF Para obter informações mais detalhadas sobre essa função, consulte Uso da função IF THEN ELSE.
AND	Retorna TRUE se as duas expressões inseridas forem TRUE. Exemplo: IF ([Canal do ticket]="Email") AND ([E-mail do emissor]="[e-mail]") THEN [ID do ticket] ENDIF Retorna todos os tickets que foram recebidos por e-mail de [e-mail].
OR	Retorna TRUE se pelo menos uma das duas expressões inseridas for TRUE. Exemplo: IF ([Canal do ticket]="Email") OR ([Canal do ticket]="Twitter") THEN [ID do ticket] ENDIF Retorna todos os tickets que foram recebidos por e-mail ou Twitter.
NOT	Inverte o valor lógico da expressão inserida. Exemplo: IF NOT([Canal do ticket]="Email") THEN [ID do ticket] ENDIF Retorna todos os tickets que não foram recebidos pelo canal de e-mail.
TRUE	Retorna o valor lógico "TRUE".
FALSE	Retorna o valor lógico "FALSE".
IN(_param,_matriz)	Retorna TRUE se o primeiro parâmetro inserido estiver na matriz especificada pelo segundo parâmetro inserido. Exemplos: IN(200,ARRAY(100,200,300,400)) retornará TRUE IN(250,ARRAY(20,40,60,80)) retornará FALSE
Expressão condicional SWITCH	A expressão SWITCH é uma alternativa mais fácil às instruções IF THEN ELSE com várias ramificações. SWITCH (_elemento_testado) { CASE _value1: _valor_retorno CASE _value2: _valor_retorno DEFAULT: _valor_retorno_padrão } Para obter informações aprofundadas sobre essa função, consulte Adição de várias expressões condicionais com SWITCH.

Funções de atributo

Estas funções permitem que você realize operações básicas para quantificar o número de atributos retornados pelo seu relatório. Você também pode executar operações mais avançadas para "bloquear" ou estender o nível de agregação de seus cálculos.

Função	Descrição
COUNT_VALUES(_atributo)	Conta o número de valores do atributo inserido. Valores repetidos são incluídos. Pode ser usada como uma condição em métricas e atributos calculados, mas não pode ser usado na cláusula THEN de uma métrica calculada. Exemplo: IF COUNT_VALUES([ID do ticket])>30 THEN 1 ELSE 0 ENDIF O exemplo acima retorna 1 quando há mais de 30 tickets e 0 quando há menos de 30. Dica: se você deseja criar uma métrica que conte o número de valores de um atributo, a fórmula da métrica deve ser simplesmente [Atributo]. Você pode então aplicar o agregador COUNT normalmente.
DCOUNT_VALUES(_atributo)	Conta o número distinto de valores diferentes do atributo inserido. Pode ser usada como uma condição em métricas e atributos calculados, mas não pode ser usado na cláusula THEN de uma métrica calculada. Exemplo: IF COUNT_VALUES([Nome da organização])>100 THEN 1 ELSE 0 ENDIF O exemplo acima retorna 1 quando há mais de 100 organizações distintas e 0 quando há menos de 100. Dica: se você deseja criar uma métrica que conte o número de valores distintos de um atributo, a fórmula da métrica deve ser simplesmente [Atributo]. Você pode então aplicar o agregador D_COUNT normalmente.
ATTRIBUTE_FIX(agregador(nome da métrica), atributo1, atributo2)	Retorna o valor de agregador(nome da métrica), agregado pelos atributos que você especificou; nesse exemplo, atributo1 e atributo2. Nenhum outro atributo pode afetar os resultados dessa métrica. Os atributos calculados não podem ser usados dentro da função ATTRIBUTE_FIX. Exemplo: ATTRIBUTE_FIX(MED(Tempo da primeira resposta (min), [Criação do ticket - ano], [Criação do ticket - mês]) Para obter mais ajuda e exemplos, consulte Trabalho com funções de nível de agregação.
ATTRIBUTE_ADD(agregador(nome da métrica), atributo1, atributo2)	Retorna o valor de agregador(nome da métrica), agrupado pelos atributos no relatório em complemento a atributo1 e atributo2. Os atributos calculados não podem ser usados dentro da função ATTRIBUTE_ADD. Exemplo: ATTRIBUTE_ADD(MED(Tempo da primeira resposta (min), [Criação do ticket - ano], [Criação do ticket - mês]) Para obter mais ajuda e exemplos, consulte Trabalho com funções de nível de agregação.

Funções de tag

Estas funções ajudam você a pesquisar pela presença ou ausência de tags. Isso inclui tags de tickets, tags de chamadas ou tudo que usa tags.

Função	Descrição
INCLUDES_ALL([atributo de tag], "tag1", "tag2") ou INCLUDES([atributo de tag ], "tag1", "tag2")	Retorna TRUE se todas as tags especificadas estiverem inclusas no atributo de tag. Exemplos: INCLUDES_ALL([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket tem as tags "Londres" e "Milão". NOT INCLUDES_ALL ([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket não tiver ambas as tags "Londres" e "Milão". Para ver mais exemplos sobre como usar essa função, consulte Relatórios com tags.
INCLUDES_ANY([atributo de tag], "tag1", "tag2")	Retorna TRUE se alguma das tags especificadas estiver inclusa no atributo de tag. Exemplos: INCLUDES_ANY([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket tem as tags "Londres" ou "Milão". NOT INCLUDES_ANY ([Tags de Ticket], "Londres", "Milão") retorna TRUE se o ticket não tiver nenhuma das tags "Londres" ou "Milão". Para ver mais exemplos sobre como usar essa função, consulte Relatórios com tags.

Funções de texto

Estas funções permitem que você realize operações de pesquisa e avaliação de texto. Também é possível modificar o texto usando fórmulas e padrões criados por você.

Para obter exemplos de como usar algumas dessas funções de texto (como CONTAINS, LEFTPART, SUBSTR, FIND e LENGTH), consulte Receita do Explore: relatórios sobre campos de lista suspensa aninhados.

Função	Descrição
CONTAINS(_texto,_texto_para_pesquisa)	Retorna TRUE se o primeiro parâmetro inserido contiver o segundo como uma subcadeia. Exemplo: CONTAINS([Nome do emissor],"Sally") Retornará TRUE se o nome do emissor for "Sally Jones" Retornará FALSE se o nome do emissor for "Rachel Jones"
ENDSWITH(_texto,_texto_para_pesquisa)	Retorna TRUE se o primeiro texto inserido terminar com o segundo. Exemplo: ENDSWITH([Estado dos EUA],"ippi") retornará TRUE para Mississippi, mas FALSE para Delaware.
FIND(_texto,_texto_para_pesquisa,_número_início_índice)	Retorna o índice, no primeiro texto inserido, da primeira instância do segundo texto inserido a partir do índice inicial inserido. Retorna -1 se o segundo texto inserido não for encontrado. O índice do primeiro caractere de uma cadeia é 0. Exemplos: Se [Modo de transporte]="Urgent", então FIND([Modo de transporte],"Norm",0) retornará -1 Se [Modo de transporte]="Normal", então FIND([Modo de transporte],"ma",0) retornará 3 Se [Modo de transporte]="Urgent", então FIND([Modo de transporte],"ge",2) retornará 0
LEFTPART(_texto,_número)	Retorna o (_número) de caracteres mais à esquerda do texto inserido. Exemplo: Se [Departamento]="Documentos técnicos", então LEFTPART([Departamento],9) retornará "Documentos"
LENGTH(_texto)	Retorna o comprimento (número de caracteres) do texto inserido. Exemplo: LENGTH([Categoria de produto]) retornará o comprimento de cada valor do atributo Categoria de produto.
LOWERCASE(_texto)	Converte e retorna o texto inserido em caixa baixa.
LTRIM(_texto)	Retorna o valor do atributo inserido com todos os espaços em branco mais à esquerda removidos. Exemplo: LTRIM([Nome]) retornaria “Peter” se [Nome] fosse “ Peter ”
REPLACE(_texto,_texto_a_substituir,_texto_de_substituição)	Retorna uma cópia de _texto em que todas as instâncias de _texto_a_substituir foram substituídas por _texto_de_substituição. Exemplo: IF [Estado dos EUA]="new York", então REPLACE([Estado dos EUA],"n","N") retornará "New York"
RIGHTPART(_texto,_número)	Retorna o _número de caracteres mais à direita no texto inserido. Exemplo: Se [Departamento]="Documentos técnicos", então RIGHTPART([Departamento],13) retornará "técnicos"
RTRIM(_texto)	Retorna o valor do atributo inserido com todos os espaços em branco mais à direita removidos. Exemplo: TRIM([Nome]) retornaria “ Peter” se [Nome] fosse “ Peter ”
STARTSWITH(_texto,_texto_para_pesquisa)	Retorna TRUE se o primeiro texto inserido começar com o segundo texto inserido. Exemplo: STARTSWITH([Estado dos EUA],"Miss") retornará TRUE para Mississippi, mas FALSE para Delaware.
IS_POSITIVE(_texto)	Retorna TRUE para positivo e FALSE para negativo com base na análise do texto.
SUBSTR(_texto,_número_início_índice,_número_fim_índice)	Retorna a parte do _texto que consiste no caractere especificado pelo índice inicial (o primeiro inteiro inserido) e todos os caracteres até o índice final-1 (o segundo inteiro inserido). Exemplo: SUBSTR("Web marketing",0,3) retornará "Web"
TRIM(_texto)	Retorna o valor do atributo inserido com todos os espaços em branco à direita e à esquerda removidos. Exemplo: TRIM([Nome]) retornaria “Peter” se [Nome] fosse “ Peter ”:
UPPERCASE(_texto)	Converte e retorna o texto inserido em caixa alta.
STRING(_número)	Converte o número inserido em uma cadeia de caracteres.
LPAD(_texto,_comprimento,_preenchimento)	Adiciona texto à esquerda de _texto com _preenchimento até a cadeia de caracteres estar no valor de _comprimento. Exemplo: LPAD("1",7,"?") retornará "??????1"
RPAD(_texto,_comprimento,_preenchimento)	Adiciona texto à direita de _texto com _preenchimento até a cadeia de caracteres estar no valor de _comprimento. Exemplo: RPAD("1",7,"?") retornará "1??????"
LINK(_url,_rótulo)	Retorna um link HTML que aponta para a URL inserida. Para ver um exemplo, consulte Receita do Explore: configuração de links clicáveis para tickets.

Funções de regex

Uma expressão regular (também conhecida como regex ou regexp) é uma sequência de caracteres que define um padrão de pesquisa. O Explore oferece suporte no uso de expressões regulares para realizar os seguintes cálculos em suas fórmulas:

Função	Descrição
REGEXP_MATCH(_texto,_regexp)	Retorna true se o texto corresponder à expressão regular.
REGEXP_EXTRACT(_texto,_regexp)	Retorna a parte do texto que corresponde ao grupo de coleta dentro da expressão regular. Para obter um exemplo de como usar essa função, consulte Como crio relatórios sobre o domínio de e-mail do usuário no Explore?
REGEXP_REPLACE(_texto,_regexp,_texto_substituição)	Retorna uma cadeia de caracteres na qual qualquer subcadeia de texto que corresponda à expressão regular é substituída por texto_substituição. Exemplo: REGEXP_REPLACE("Ajuda","jud","rar") retornará "Arara"

Para obter mais informações sobre expressões regulares, consulte esta página da Wikipédia.

Funções de data

O Explore permite que você crie, compare e realize cálculos em datas e horários. Estas funções são especialmente úteis porque é provável que você passe muito tempo analisando as informações da sua empresa em um determinado intervalo de datas.

Função	Descrição
DATE(_texto)	Retorna uma nova data para o texto inserido. Exemplo: DATE("7/24/1980")
DATE(_ano,_mês,_dia,_hora,_minuto,_segundo)	Retorna uma nova data para o texto inserido. Você deve inserir, pelo menos, o ano, o mês e o dia. Exemplo: DATE("1995","06","09","13","15","00")
DATE_EQUAL(_data,_data)	Retorna TRUE se as duas datas inseridas forem iguais. Exemplo: IF DATE_EQUAL([Criação do ticket - mês],[Resolução do ticket - mês]) THEN [ID do ticket] ENDIF Retorna todos os tickets resolvidos no mesmo mês em que foram criados. O ano não é incluído nesse exemplo. Então um ticket que foi criado em junho de 2018 e resolvido em junho de 2020 será retornado por esse exemplo.
DATE_NOT_EQUAL(_data,_data)	Retorna TRUE se as duas datas inseridas forem diferentes. Exemplo: IF DATE_EQUAL([Criação do ticket - mês],[Resolução do ticket - mês]) THEN [ID do ticket] ENDIF Retorna todos os tickets que não foram resolvidos no mesmo mês em que foram criados.
DATE_LESS(_data,_data)	Retorna TRUE se a primeira data for anterior à segunda data. Exemplo: IF DATE_LESS([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets atribuídos antes da data de vencimento deles.
DATE_LESS_OR_EQUAL(_data,_data)	Retorna TRUE se a primeira data for anterior ou igual à segunda data. Exemplo: IF DATE_LESS_OR_EQUAL([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets que foram atribuídos antes ou na data de vencimento.
DATE_GREATER(_data,_data)	Retorna TRUE se a primeira data for posterior à segunda data. Exemplo: IF DATE_GREATER([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets atribuídos após a data de vencimento deles.
DATE_GREATER_OR_EQUAL(_data,_data)	Retorna TRUE se a primeira data for posterior ou igual à segunda data. Exemplo: IF DATE_GREATER_OR_EQUAL([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets que foram atribuídos na data de vencimento ou depois dela.
DATE_ADD(_data,_data_parte,_incremento)	Retorna a data fornecida atualizada com o incremento inserido. O parâmetro _data_parte pode ser por exemplo, "year", "quarter", "month", "day", "hour" etc. O incremento inserido deve ser um número inteiro, mas pode ser negativo.
DATE_DIFF(_data,_data,_data_parte)	Retorna a diferença relativa ou absoluta entre duas datas no formato que você escolher; _data_parte pode ser uma das seguintes: Para diferenças relativas (números inteiros): "year" "half_year" "quarter" "month" "day" "hour" "minute" "second" Para valores absolutos (exatos): "nb_of_years" "nb_of_half_years" "nb_of_quarters" "nb_of_months" "nb_of_days" "nb_of_hours" "nb_of_minutes" "nb_of_seconds" Exemplos: DATE_DIFF("2011/10/22","2008/01/06","year") retorna 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") retorna 4 (contagem real de anos) DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") retorna 731 DATE_DIFF("2019/03/06","2017/03/05","day") retorna 1
DATE_FORMAT(_data,_formato)	Retorna a data inserida no formato fornecido. Para ver a lista de formatos disponíveis, consulte Formatação de datas.
TODAY()	Retorna a data atual (GMT)
NOW()	Retorna a data e a hora (GMT) atuais (horas, minutos, segundos)
CURRENT_YEAR()	Retorna o ano atual (GMT).
CURRENT_HALFYEAR()	Retorna o semestre atual (GMT) como "H1" ou "H2"
CURRENT_QUARTER()	Retorna o trimestre atual (GMT) como "Q1", "Q2", "Q3" ou "Q4"
CURRENT_MONTH()	Retorna o mês atual (GMT), por exemplo, "janeiro", "fevereiro".
CURRENT_MONTH_NUMERIC()	Retorna o mês atual (GMT) como número, por exemplo, "1" para janeiro, "2" para fevereiro.
CURRENT_DAY()	Retorna o dia atual (GMT) como número.
CURRENT_WEEKDAY()	Retorna o atual dia da semana (GMT) como texto, por exemplo, "segunda-feira", "terça-feira".
CURRENT_WEEKDAY_NUMERIC()	Retorna o atual dia da semana (GMT) como número, por exemplo "0" para domingo, "1" para segunda-feira.
CURRENT_HOUR()	Retorna a hora atual (GMT) como número.
CURRENT_MINUTE()	Retorna o minuto atual (GMT) como número.
CURRENT_SECOND()	Retorna o segundo atual (GMT) como número.
YEAR(_data)	Retorna o ano da data fornecida.
MONTH(_data)	Retorna o mês da data fornecida como texto, por exemplo, "janeiro", "fevereiro"
MONTH_NUMERIC(_data)	Retorna o mês da data fornecida como número, por exemplo, "1" para janeiro e "2" para fevereiro.
DAY(_data)	Retorna o dia da data inserida.
WEEKDAY(_data)	Retorna o dia da data inserida como cadeia de caracteres, por exemplo, "segunda-feira", "terça-feira".
WEEKDAY_NUMERIC(_data)	Retorna o dia da data inserida como número, por exemplo, "1" para domingo e "2" para segunda-feira.
HOURS(_data)	Retorna a hora da data inserida.
MINUTES(_data)	Retorna o minuto da data inserida.
SECONDS(_data)	Retorna o segundo da data inserida.
WEEK_NUMBER(_date)	Retorna o número da semana associado à data inserida. Consulte Noções básicas sobre como o início de semana afeta os números da semana.
WEEK_NUMBER_MONDAY(_data)	Retorna o número da semana associado à data inserida começando na segunda-feira.
WEEK_NUMBER_FRIDAY(_data)	Retorna o número da semana associado à data inserida começando na sexta-feira.
WEEK_NUMBER_SATURDAY(_data)	Retorna o número da semana associado à data inserida começando no sábado.
WEEK_NUMBER_SUNDAY(_data)	Retorna o número da semana associado à data inserida começando no domingo.
START_OF_QUARTER(_data)	Retorna o início do trimestre da data inserida.
END_OF_QUARTER(_data)	Retorna o fim do trimestre da data inserida.
START_OF_MONTH(_data)	Retorna o início do mês (GMT) da data inserida.
END_OF_MONTH(_data)	Retorna o fim do mês (hora em GMT) da data inserida.
START_OF_WEEK(_date)	Retorna o início da semana da inserida. Consulte Configuração do início da semana para relatórios e filtros.
END_OF_WEEK(_date)	Retorna o fim da semana da data inserida. Consulte Configuração do início da semana para relatórios e filtros.
START_OF_WEEK_MONDAY(_data)	Retorna o início da semana que corresponde à data inserida, com a semana que começa na segunda-feira.
END_OF_WEEK_MONDAY(_data)	Retorna o fim da semana que corresponde à data inserida, com a semana que começa na segunda-feira.
START_OF_WEEK_FRIDAY(_data)	Retorna o início da semana que corresponde à data inserida, com a semana que começa na sexta-feira.
END_OF_WEEK_FRIDAY(_data)	Retorna o fim da semana que corresponde à data inserida, com a semana que começa na sexta-feira.
START_OF_WEEK_SATURDAY(_data)	Retorna o início da semana que corresponde à data inserida, com a semana que começa no sábado.
END_OF_WEEK_SATURDAY(_data)	Retorna o fim da semana que corresponde à data inserida, com a semana que começa no sábado.
START_OF_WEEK_SUNDAY(_data)	Retorna o início da semana que corresponde à data inserida, com a semana que começa no domingo.
END_OF_WEEK_SUNDAY(_data)	Retorna o fim da semana que corresponde à data inserida, com a semana que começa no domingo.
DATE_FROM_TIMESTAMP(_carimbo)	Retorna a data de um carimbo de data/hora UNIX em segundos.
DATE_FROM_MILLI_TIMESTAMP(_carimbo)	Retorna a data de um carimbo de data/hora UNIX em milissegundos.
DATE_TO_TIMESTAMP(_data)	Retorna um carimbo de data/hora UNIX de uma data.
DATE_TO_MILLI_TIMESTAMP(_data)	Returna um carimbo de data/hora UNIX em milissegundos de uma data.
SECONDS_TO_TIME(_hora)	Converte segundos para o formato HH:MM:SS.
FISCAL_YEAR(_data,_mês_inicial)	Retorna o ano fiscal de acordo com a data inserida e o mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev").
FISCAL_QUARTER(_data,_mês_inicial)	Retorna o trimestre fiscal de acordo com a data inserida e o mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev").
FISCAL_WEEK_NUMBER(_data,_mês_inicial)	Retorna o número da semana fiscal com base na data inserida e no mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev").
WEEKYEAR(_data)	Retorna o ano do número da semana associado à data inserida.
DATE_FIRST(atributo de tempo)	Retorna a data ou carimbo de data/hora mais antigo de acordo com os atributos adicionados ao relatório e é afetada por todos os filtros aplicados. Exemplo: DATE_FIRST([Atualização - carimbo de data/hora]) Retorna o carimbo de data/hora da primeira atualização levando em conta todos os atributos adicionados ao relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes.
DATE_LAST(atributo de tempo)	Retorna a data ou carimbo de data/hora mais recente de acordo com os atributos adicionados ao relatório e é afetada por todos os filtros aplicados. Exemplo: DATE_LAST([Atualização - carimbo de data/hora]) Retorna o carimbo de data/hora da atualização mais recente levando em conta todos os atributos adicionados ao relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes.
DATE_FIRST_FIX(atributo de tempo, atributo1, atributo2, ...)	Retorna a data ou carimbo de data/hora mais antigo de acordo com os atributos especificados na função. Os atributos adicionados ao relatório não afetarão o cálculo, mas todos os filtros aplicados serão levados em consideração. Exemplo: DATE_FIRST_FIX([Atualização - carimbo de data/hora], [ID do ticket da atualização]) Retorna o carimbo de data/hora da primeira atualização por ticket, independentemente dos atributos do relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes.
DATE_LAST_FIX(atributo de tempo, atributo1, atributo2, ...)	Retorna a data ou carimbo de data/hora mais recente de acordo com os atributos especificados na função. Os atributos adicionados ao relatório não afetarão o cálculo, mas todos os filtros aplicados serão levados em consideração. Exemplo: DATE_LAST_FIX([Atualização - carimbo de data/hora], [ID do ticket da atualização]) Retorna o carimbo de data/hora da atualização mais recente por ticket, independentemente dos atributos do relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes.

Formatação de datas

A função DATE_FORMAT retorna carimbos de data/hora completos como diferentes tipos de data. Cada formato é representado por uma letra diferente. Insira a letra associada na parte do formato da função DATE_FORMAT. Todo o texto deve ser inserido entre aspas duplas.

Observação: é possível combinar componentes de data ou hora para exibir mais informações sobre uma data. Por exemplo, se você quiser visualizar o mês e o ano de uma data, pode usar "MM-yyyy" ou, se quiser ver os minutos e os segundos de uma data, use "mm-ss". Se você escolher usar vários componentes de data simultaneamente, deverá incluir um traço entre os diferentes formatos.

A tabela mostra os formatos disponíveis. O exemplo usa o carimbo de data/hora, 2017-11-03T03:18:25.

Componente de data ou hora	Letra	O exemplo usa 2017-11-03T03:18:25
Era	G	AD
Ano	y	2017
Número do mês	M	11
Nome do mês	Mon	Nov
Nome do mês	MON	NOV
Nome do mês	Month	novembro
Nome do mês	MONTH	NOVEMBRO
Número da semana	w	44
Número do dia do ano	D	307
Número do dia do mês	d	3
Nome do dia da semana	E	Sex
AM ou PM	a	AM
Hora do dia (0-23)	H	3
Hora do dia (1-24)	k	3
Hora em AM/PM (0-11)	K	3
Hora em AM/PM (1-12)	h	3
Minutos	m	18
Segundos	s	25
Milissegundo	S	0
Fuso horário (UTC)	z	GMT
Fuso horário (RFC)	Z	-800

Funções numéricas

Estas funções permitem que você realize diversos tipos de cálculos matemáticos nas informações em seus relatórios.

Função	Descrição
ABS(_número)	Retorna o valor absoluto do número inserido. Exemplos: O valor absoluto de 1 é 1 O valor absoluto de -7,3 é 7,3
BETWEEN(_número,_número,_número)	Retorna TRUE se o primeiro número inserido estiver entre os outros dois números. Exemplo: BETWEEN(SUM(Lucro),500,1500) retornará TRUE se SUM(Lucro) for igual a ou estiver entre 500 e 1500.
CEIL(_número)	Retorna o teto do número inserido. O teto de um número é o valor inteiro maior e mais próximo ou igual. Exemplos: O teto de 125,4 é 126 O teto de -63,2 é -63 CEILING(SUM(Tempo da primeira resolução - minutos)) retornará o valor inteiro maior e mais próximo para cada tempo da primeira resolução armazenado no atributo.
EXP(_número)	Retorna o valor da base do logaritmo natural (e) elevado à potência do expoente inserido. Exemplo: EXP(SUM(Preço unitário)) retornará o logaritmo natural de cada valor da métrica SUM (Preço unitário).
FLOOR(_número)	Retorna o piso do número inserido. O piso de um número é seu valor inteiro menor e mais próximo ou igual. Exemplos: O piso de 125,4 é 125 O piso de -63,2 é -64 FLOOR(SUM(Tempo da primeira resolução - minutos)) retornará o inteiro menor e mais próximo de cada tempo da primeira resolução armazenado no atributo.
GROWTH_RATE(_número,_número)	Retorna a taxa de crescimento correspondente aos dois parâmetros inseridos. Exemplo: Se os dois parâmetros inseridos são X e Y, a taxa de crescimento é Y-X/ABS(X).
INTEGER(_param)	Retorna o inteiro do número não inteiro inserido. Exemplo: INTEGER(1,56) retornará 1
IS_NAN(_valor)	Retorna TRUE se o valor inserido não for um número (NAN). Exemplos: IS_NAN("Copenhagen") retornará TRUE IS_NAN(235,78) retornará FALSE
MAXIMUM(_número,_número)	Retorna o maior valor entre os dois parâmetros inseridos. MAXIMUM(SUM(Receitas),SUM(Despesas)) retornará o maior valor entre Receitas e Despesas.
MINIMUM(_número,_número)	Retorna o menor valor entre os dois parâmetros inseridos. MINIMUM(SUM(Receitas),SUM(Despesas)) retornará o menor valor entre Receitas e Despesas.
NUMBER(_param)	Retorna a representação numérica de um parâmetro fornecido ou retorna NaN quando não puder ser exibido como número. Exemplos: NUMBER("3.14116") retornará 3,14116 NUMBER([Categoria de caixa]) retornará a representação numérica do valor atual do atributo Categoria de caixa.
PI()	Retorna a constante matemática para a proporção da circunferência de um círculo para seu diâmetro, expressa como PI. O valor é de 3,141592653589793.
POWER(_número,_número)	Calcula e retorna o primeiro número inserido elevado a potência do segundo número inserido. Exemplo: IF SUM(Preço unitário)=2, então POWER(SUM(Preço unitário),3) retornará 8
RANDOM()	Retorna um número pseudoaleatório 'n' onde 0<=n<1. Se você precisar de um inteiro aleatório, use a fórmula Round(Random()*100).
ROUND(_número)	Arredonda o valor do número inserido para cima ou para baixo em relação ao inteiro mais próximo. Se equidistante, o valor é arredondado para cima.
SIGN(_número)	Retorna -1 se o número for negativo, 0 se for zero e 1 se positivo.
SQRT(_número)	Calcula e retorna a raiz quadrada do número inserido.
SQUARE(_número)	Calcula e retorna o quadrado do número inserido.
LN(_número)	Retorna o logaritmo natural do número inserido.
LOG10(_número)	Retorna o logaritmo de base -10 do número inserido.
LOG2(_número)	Retorna o logaritmo de base -2 do número inserido.
LOG(_base,_número)	Retorna o logaritmo do número inserido para a base inserida.

Funções trigonométricas

Estas funções ajudam você a criar fórmulas avançadas para calcular ângulos e distâncias.

Função	Descrição
ACOS(_número)	Calcula o cosseno do arco do número inserido em radianos.
ASIN(_número)	Calcula o seno do arco do número inserido em radianos.
ATAN(_número)	Retorna o valor, em radianos, do ângulo com a tangente inserida no parâmetro. O valor retornado está entre PI/2 negativo e PI/2 positivo.
ATAN2(_número,_número)	Retorna o ângulo do ponto Y/X em radianos, quando medido em sentido anti-horário a partir do eixo X de um círculo (0,0 representa o centro do círculo). O valor de retorno está entre PI positivo e PI negativo. Insere a coordenada Y como o primeiro parâmetro.
COS(_número)	Calcula o cosseno do número inserido em radianos.
DEGREES(_número)	Converte o número fornecido de radianos para graus.
RADIANS(_número)	Converte o número fornecido de graus para radianos.
SIN(_número)	Calcula o seno do número inserido em radianos.
TAN(_número)	Retorna a tangente do ângulo inserido.

Funções da URL

As funções da URL a seguir aparecem na lista de funções do Explore, mas não são usadas atualmente.

• HOST
• DOMAIN
• TLD

Funções do JSON

As funções do JSON a seguir aparecem na lista de funções do Explore, mas não são usadas atualmente.

• JSON_EXTRACT
• JSON_ARRAY_LENGTH
• JSON_EXTRACT_ARRAY_ELEMENT

Funções de criptografia

O Explore oferece suporte para as seguintes funções de criptografia:

Função	Descrição
HMAC(_algoritmo,_formato_saída,_chave,_mensagem)	Retorna um valor de hash com chave usando um método de autenticação da mensagem com base em hash (HMAC).