Qual é o meu plano?
Suite Professional, Enterprise ou Enterprise Plus
Support com Explore Professional ou Enterprise

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

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

    Exemplo de função do Explore

Agora, quando esse atributo é usado no relatório, ele retornará somente os tickets com uma linha de assunto que comece 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]="fred@fredco.com") THEN [ID do ticket] ENDIF

Retorna todos os tickets que foram recebidos por e-mail de fred@freedco.com.

OU Retorna TRUE se pelo menos uma das duas expressões inseridas for TRUE.

Exemplo:

IF ([canal do ticket]="Email") OR ([canal do ticket]="Voice") THEN [ID do ticket] ENDIF

Retorna todos os tickets que foram recebidos por canais de e-mail ou voz.

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.

Importante: Somente as funções nesta seção podem ser usadas para criar relatórios sobre tags. Os relatórios podem não funcionar ou retornar resultados imprecisos se você usar funções que não estejam especificadas a seguir.
Função Descrição
INCLUDES_ALL([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) Converte o texto fornecido em uma data com um carimbo de data/hora UTC. O texto inserido pode estar em diversos formatos, mas deve incluir, pelo menos, o mês, o dia e o ano.

Exemplos:

  • "2020-07-24T06:23:00+0200"
  • "2020-07-24T06:23"
  • "2020-07-24"
  • "07/24/2020"
  • "2020-Jul-24"
  • "Julho-24-2020"
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 no fuso horário do usuário, 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 exata entre duas datas no formato da sua escolha. Na função, _date_part pode ser uma das seguintes:

Para diferenças relativas (números inteiros):

  • "year"
  • "half_year"
  • "quarter"
  • "month"
  • "day"
  • "hour"
  • "minute"
  • "second"

Para valores 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","2019/03/05","day") retorna 1

DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") retorna 731

DATE_FORMAT(_data,_formato) Retorna a data inserida no fuso horário do usuário no formato fornecido.

Para ver a lista de formatos disponíveis, consulte Formatação de datas.

TODAY() Retorna a data atual no fuso horário do usuário.
NOW() Retorna a data e a hora atuais no fuso horário do usuário (em horas, minutos e segundos).
CURRENT_YEAR() Retorna o ano atual.
CURRENT_HALFYEAR() Retorna o semestre atual como "H1" ou "H2"
CURRENT_QUARTER() Retorna o trimestre atual como "Q1", "Q2", "Q3" ou "Q4"
CURRENT_MONTH() Retorna o mês atual, por exemplo, "janeiro", "fevereiro".
CURRENT_MONTH_NUMERIC() Retorna o mês atual como número, por exemplo, "1" para janeiro, "2" para fevereiro.
CURRENT_DAY() Retorna o dia atual como número.
CURRENT_WEEKDAY() Retorna o dia atual da semana como texto, por exemplo, "segunda-feira", "terça-feira".
CURRENT_WEEKDAY_NUMERIC() Retorna o dia atual da semana como número, por exemplo "0" para domingo, "1" para segunda-feira.
CURRENT_HOUR() Retorna a hora atual no fuso horário do usuário como número.
CURRENT_MINUTE() Retorna o minuto atual no fuso horário do usuário como número.
CURRENT_SECOND() Retorna o segundo atual no fuso horário do usuário 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 da data inserida.
END_OF_MONTH(_data) Retorna o fim do mês 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_ISO Retorna um carimbo de data/hora se o parâmetro for uma cadeia de caracteres de carimbo de data/hora padrão ISO. Assume que o carimbo de data/hora tem um fuso horário, mas carimbos de data/hora sem informações de fuso horário podem ser analisados definindo o parâmetro opcional skip-timezone como TRUE.

Exemplos:

DATE_FROM_ISO("2020-07-24T13:42:00Z")

DATE_FROM_ISO("2020-07-24T13:42EST")

DATE_FROM_ISO("2020-07-24T13:42+05")

DATE_FROM_ISO("2020-07-24T13:42," TRUE)

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 no fuso horário do usuário de uma data fornecida.
DATE_TO_MILLI_TIMESTAMP(_data) Retorna 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. É possível combinar componentes de data ou hora para exibir mais informações sobre uma data.

Por exemplo, para alterar o formato padrão (2015-01-27T13:21:10) do atributo Ticket criado - Carimbo de data/hora para um formato no estilo dos EUA (Jan 27, 2015 01:21 PM), use esta fórmula:

DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")

A tabela mostra os formatos disponíveis. Os exemplos usam o carimbo de data/hora 2017-11-03T15:18:25.

Componente de data ou hora Letra Exemplo usando 2017-11-03T15:18:25
Ano YYYY 2017
Ano YY 17
Trimestral Q 4º TRI
Número do mês MM 11
Nome do mês Mon Nov
Nome do mês Mensalmente novembro
Semana do ano (1–53) WW 44
Semana do mês (1-5) L 1
Número do dia do ano (01-366) DDD 307
Número do dia do mês (01-31) DD 3
Nome do dia da semana Dia Sexta-feira
Nome do dia da semana Dy Sex
Hora do dia (01-12) hh 3
Hora do dia (1-23) HH 15
Minutos MI 18
Segundos SS 25
Milissegundo (000-999) MS 0
Indicador meridiano (AM ou PM) AM PM

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.

INTEGER(_param) Retorna o inteiro do número não inteiro inserido.

Exemplo:

INTEGER(1,56) retornará 1

IS_NUMBER(_param) Retorna TRUE se o parâmetro determinado for um número (inteiro ou decimal) e FALSO se não for.

Exemplos:

  • IS_NUMBER(“-1234.987”) retorna TRUE
  • IS_NUMBER(“West”) retorna 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.
Powered by Zendesk