As funções geram um valor de retorno, que pode ser um número, texto, valor verdadeiro/falso ou tipo de data, dependendo da função. A maioria das funções exige parâmetros. Os parâmetros são as entradas na função e são especificados entre parênteses, após o nome da função e separados por vírgula. A ordem dos parâmetros e o formato de dados de cada um deles são importantes. Quando você adiciona uma função no menu, o texto do marcador de posição de cada parâmetro é inserido. É necessário substituir o texto do marcador de posição para concluir a função. As funções com "..." aceitam qualquer quantidade de parâmetros adicionais.
No artigo Criar colunas personalizadas, veja instruções sobre como usar os funções nas colunas personalizadas.
Categoria | Tipo de retorno | Função | Descrição |
Aritmética | Número | round(x) |
Arredonda [x] para o número inteiro mais próximo |
Aritmética | Número | floor(x) |
Retorna o maior número inteiro menor ou igual a [x] |
Aritmética | Número | ceiling(x) |
Retorna o menor número inteiro maior ou igual a [x] |
Lógica | Varia | if(condition, if_true, if_false) |
Avalia [condition] e retorna [if_true] se a condição é verdadeira e [if_false] se ela é falsa. O valor de retorno será do mesmo tipo que [if_true] e [if_false]. |
Lógica | Verdadeiro/Falso | or(x, y, ...) |
Retorna "True" se um dos parâmetros é verdadeiro |
Lógica | Verdadeiro/Falso | not(x) |
Retorna "True" se a condição [x] é falsa e "False" se ela é verdadeira |
Lógica | Verdadeiro/Falso | and(x, y, ...) |
Retorna "True" se todos os parâmetros são verdadeiros |
Texto | Texto | concat(text1, text2, ...) |
Combina duas ou mais strings de texto |
Texto | Verdadeiro/Falso | is_empty(text) |
Retorna "True" se [text] não tem caracteres |
Texto | Texto | trim(text) |
Remove o espaço em branco ao redor da string de texto |
Texto | Verdadeiro/Falso | starts_with(needle, haystack) |
Retorna "True" se a string de texto [haystack] começa com [needle] |
Texto | Verdadeiro/Falso | ends_with(needle, haystack) |
Retorna "True" se a string de texto [haystack] termina com [needle] |
Texto | Número | search(needle, haystack) |
Retorna à posição inicial de [needle] em [haystack] |
Texto | Verdadeiro/Falso | contains(needle, haystack) |
Retorna "True" quando a string de texto [haystack] contém [needle] |
Texto | Texto | right(text, length) |
Retorna os [length] últimos caracteres de [text] |
Texto | Texto | left(text, length) |
Retorna os [length] primeiros caracteres de [text] |
Texto | Texto | substitute(haystack, needle, replacement) |
Substitui todas as ocorrências de [needle] em [haystack] por [replacement] |
Texto | Texto | upper(text) |
Converte todos os caracteres em [text] para LETRA MAIÚSCULA |
Texto | Texto | lower(text) |
Converte todos os caracteres em [text] para letra minúscula |
Texto | Número | length(text) |
Retorna o número de caracteres em [text] |
Conversão | Texto | to_text(value) |
Converte [value] em texto |
Conversão | Número | to_number(value) |
Converte [value] em um número |
Data | Data | date(year, month, day) |
Retorna uma data com o ano, o mês e o dia especificados |
Data | Número | day(date) |
Retorna o dia do mês de [date] |
Data | Número | month(date) |
Retorna o mês do ano (de 1 a 12) de [date] |
Data | Número | quarter(date) |
Retorna o trimestre do ano (de 1 a 4) de [data] |
Data | Número | year(date) |
Retorna o ano de [date] em número |
Data | Número | weekday(date) |
Retorna o dia da semana (de 1 a 7) de [date], e domingo equivale a 1. |
Data | Número | weeknum(date) |
Retorna o número da semana atual em um ano (de 1 a 54) de [date], e as semanas começam no domingo |
Data | Número | daynum(date) |
Retorna o dia do ano (de 1 a 355 ou 356) de [date] |
Data | Número | days_between(date1, date2) |
Retorna o número de dias entre [date1] e [date2] |
Data | Data | offset_days(date, days) |
Adiciona os dias de [days] a [date], contando a partir de/desde de determinado dia |
Data | Data | offset_months(date, months) |
Adiciona [months] ao componente de mês de [date], e, se o mês correspondente não tem dias suficientes para o componente de dia, o último dia do novo mês é retornado |
Data | Data | offset_years(date, years) |
Adiciona [years] ao componente de ano de [date] |
Data | Data | today() |
Retorna a data atual no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | yesterday() |
Retorna a data do dia anterior no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | week_start_sunday() |
Retorna a data do domingo mais recente no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | week_start_monday() |
Retorna a data da segunda-feira mais recente no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | month_start() |
Retorna a primeira data do mês atual no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | year_start() |
Retorna a primeira data do ano atual (1º de janeiro) no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | report_range_start() |
Retorna a data no início do período atual do relatório |
Data | Data | report_range_end() |
Retorna a data de término do período atual do relatório |
Data | Número | report_days_count() |
Retorna o número de dias cobertos pelo relatório com base nas datas de início e término |