As funções produzem um resultado designado por valor devolvido (que pode ser do tipo número, texto, valor verdadeiro/falso ou data, consoante a função). A maioria das funções requer parâmetros. Os parâmetros são elementos de entrada na função e são especificados entre parênteses após o nome da função, separados por vírgulas. A ordem dos parâmetros e o formato de dados de cada parâmetro são importantes. Ao inserir uma função a partir de um menu, é inserido um marcador de posição em texto para cada parâmetro. Tem de substituir o texto do marcador de posição de cada parâmetro para completar a função. As funções com "..." podem aceitar muitos parâmetros adicionais.
Para obter instruções sobre como utilizar funções em colunas personalizadas, consulte o artigo Crie colunas personalizadas.
Categoria | Tipo devolvido | 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) |
Devolve o maior número inteiro igual ou inferior a [x] |
Aritmética | Número | ceiling(x) |
Devolve o menor número inteiro igual ou superior a [x] |
Lógica | Varia | if(condition, if_true, if_false) |
Avalia a condição [condition] e devolve o valor [if_true] se a condição for verdadeira e o valor [if_false] se a condição for falsa. O valor devolvido tem o mesmo tipo que [if_true] e [if_false]. |
Lógica | Verdadeiro/falso | or(x, y, ...) |
Devolve o valor True se um dos parâmetros for verdadeiro |
Lógica | Verdadeiro/falso | not(x) |
Devolve o valor True se [x] for falso e devolve o valor False se [x] for verdadeiro |
Lógica | Verdadeiro/falso | and(x, y, ...) |
Devolve o valor True se todos os parâmetros forem verdadeiros |
Texto | Texto | concat(text1, text2, ...) |
Combina 2 ou mais strings de texto |
Texto | Verdadeiro/falso | is_empty(text) |
Devolve o valor True se [text] não tiver nenhum caráter |
Texto | Texto | trim(text) |
Remove os espaços em branco à volta de uma string de texto |
Texto | Verdadeiro/falso | starts_with(needle, haystack) |
Devolve o valor True se o string de texto [haystack] começar com [needle] |
Texto | Verdadeiro/falso | ends_with(needle, haystack) |
Devolve o valor True se o string de texto [haystack] terminar com [needle] |
Texto | Número | search(needle, haystack) |
Devolve a posição inicial da primeira instância de [needle] em [haystack] |
Texto | Verdadeiro/falso | contains(needle, haystack) |
Devolve o valor True quando a string de texto [haystack] contém [needle] |
Texto | Texto | right(text, length) |
Devolve os últimos [length] carateres de [text] |
Texto | Texto | left(text, length) |
Devolve os primeiros [length] carateres de [text] |
Texto | Texto | substitute(haystack, needle, replacement) |
Substitui todas as instâncias de [needle] em [haystack] por [replacement] |
Texto | Texto | upper(text) |
Converte todos os carateres de [text] em MAIÚSCULAS |
Texto | Texto | lower(text) |
Converte todos os carateres de [text] em minúsculas |
Texto | Número | length(text) |
Devolve o número de carateres em [text] |
Conversão | Texto | to_text(value) |
Converte [value] em texto |
Conversão | Número | to_number(value) |
Converte [value] num número |
Data | Data | date(year, month, day) |
Devolve uma data com o ano, o mês e o dia especificados |
Data | Número | day(date) |
Devolve o dia do mês de [date] |
Data | Número | month(date) |
Devolve o mês do ano (1 a 12) de [date] |
Data | Número | quarter(date) |
Devolve o trimestre do ano (1 a 4) de [data] |
Data | Número | year(date) |
Devolve o ano de [data] como um número |
Data | Número | weekday(date) |
Devolve o dia da semana (1 a 7) de [date], sendo que 1 é domingo |
Data | Número | weeknum(date) |
Devolve o número da semana atual do ano (1 a 54) de [date], sendo domingo o primeiro dia da semana |
Data | Número | daynum(date) |
Devolve o dia do ano (1 a 365 ou 366) de [date] |
Data | Número | days_between(date1, date2) |
Devolve o número de dias entre [date1] e [date2] |
Data | Data | offset_days(date, days) |
Adiciona [days] dias de calendário a [date], para a frente ou para trás |
Data | Data | offset_months(date, months) |
Adiciona [months] ao componente de mês de [data]; se o mês resultante não tiver dias suficientes para o componente de dia, é devolvido o último dia do novo mês. |
Data | Data | offset_years(date, years) |
Adiciona [years] ao componente de ano de [date] |
Data | Data | today() |
Devolve a data atual no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | yesterday() |
Devolve a data do dia anterior no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | week_start_sunday() |
Devolve a data do domingo mais recente no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | week_start_monday() |
Devolve a data da segunda-feira mais recente no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | month_start() |
Devolve a primeira data do mês atual no fuso horário da conta do proprietário da coluna personalizada |
Data | Data | year_start() |
Devolve 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() |
Devolve a data no início do intervalo de tempo atual do relatório. |
Data | Data | report_range_end() |
Devolve a data no final do intervalo de tempo atual do relatório |
Data | Número | report_days_count() |
Devolve o número de dias abrangidos pelo relatório com base na respetiva data de início e de conclusão |