Sintaxe e funções de fórmulas
As fórmulas do Notion funcionam em várias propriedades e funções. Aqui você encontrará uma lista delas ➗
Quer aprender o básico sobre fórmulas? Confira nosso artigo de introdução:
As fórmulas do Notion funcionam em várias propriedades e funções. Aqui você encontrará uma lista delas!
As fórmulas suportam muitos tipos de propriedades. Para aquelas que não são suportados diretamente, os dados são automaticamente convertidos em outro tipo de dados (geralmente texto).
Tipos de propriedade | Exemplos | Tipo de fórmula |
---|---|---|
Título |
| Texto |
Texto |
| Texto |
Selecionar |
| Texto |
Seleção múltipla |
| Texto |
Caixa de seleção |
| Booleano |
E-mail, URL, Número de telefone |
| Texto |
IDs exclusivos |
| Texto |
Criado por, |
| Pessoa |
Pessoa |
| Pessoa |
Data, |
| Data |
Número |
| Número |
Relação |
| Página |
Rollup |
| Número, data ou lista de qualquer tipo. Depende da configuração do rollup. |
Os elementos nativos são símbolos e valores específicos que são intrínsecos à linguagem para auxiliar a designação de um cálculo.
Elementos nativos | Exemplo |
---|---|
Operadores matemáticos: |
|
Valores booleanos: |
|
Operadores de comparação: |
|
Operadores lógicos: |
|
Operador ternário: |
|
As fórmulas do Notion suportam as seguintes funções.
Nome | Descrição | Exemplo |
---|---|---|
if | Retorna o primeiro valor se a condição for verdadeira; caso contrário, retorna o segundo valor. |
|
ifs | Retorna o valor que corresponde à primeira condição verdadeira. Pode ser utilizado como uma alternativa a diversas declarações if() aninhadas. |
|
empty | Retorna "true" se o valor estiver vazio. 0, “” e [] são considerados vazios. |
|
length | Retorna o comprimento dos valores de texto ou da lista. |
|
substring | Retorna a parte do texto do índice inicial (inclusive) até o índice final (opcional e excludente). |
|
contains | Retorna "true" se a string pesquisada estiver no valor. |
|
Test | Retorna "true" se o valor corresponder à expressão regular; caso contrário, retorna "false". |
|
match | Retorna todas as correspondências da expressão regular como uma lista. |
|
replace | Substitui a primeira correspondência da expressão regular com o valor de substituição. |
|
replaceAll | Substitui todas as correspondências da expressão regular com o valor de substituição. |
|
lower | Converte o texto para letras minúsculas. |
|
upper | Converte o texto para letras maiúsculas. |
|
repeat | Repete o texto uma determinada quantidade de vezes. |
|
link | Cria um hiperlink a partir do texto da etiqueta e do URL. |
|
style | Adiciona estilos e cores ao texto. Estilos de formatação válidos: |
|
unstyle | Remove os estilos de formatação do texto. Se não houver estilos especificados, todos os estilos serão removidos. |
|
format | Retorna o valor formatado como texto. |
|
add | Retorna a soma de dois números. |
|
subtract | Retorna a diferença de dois números. |
|
multiply | Retorna o produto de dois números. |
|
mod | Divide o primeiro número pelo segundo e retorna o resto da operação. |
|
pow | Retorna o resultado de uma base elevada a uma determinada potência. |
|
divide | Retorna o quociente de dois números. |
|
min | Retorna o menor número dos argumentos. |
|
max | Retorna o maior número dos argumentos. |
|
sum | Retorna a soma dos argumentos. |
|
Mediana | Retorna o valor mediano dos argumentos. |
|
média | Retorna a média aritmética dos argumentos. |
|
abs | Retorna o valor absoluto do número. |
|
round | Retorna o valor de um número arredondado para o inteiro mais próximo. |
|
ceil | Retorna o menor inteiro maior ou igual do número. |
|
floor | Retorna o maior inteiro menor ou igual do número. |
|
sqrt | Retorna a raiz quadrada positiva do número. |
|
cbrt | Retorna a raiz cúbica do número. |
|
exp | Retorna e^x, em que x é o argumento, e e é a constante de Euler (2,718...), a base do logaritmo natural. |
|
ln | Retorna o logaritmo natural do número. |
|
log10 | Retorna o logaritmo de base 10 do número. |
|
log2 | Retorna o logaritmo de base 2 do número. |
|
sign | Retorna 1 se o número for positivo, -1 se for negativo, e 0 se for zero. |
|
pi | Retorna o raio da circunferência de um círculo em relação ao diâmetro. |
|
e | Retorna a base do logaritmo natural. |
|
toNumber | Analisa um número a partir do texto. |
|
now | Retorna a data e hora atuais. |
|
hoje | Retorna a data atual sem hora. |
|
minute | Retorna o minuto da data (0-59). |
|
hour | Retorna a hora da data (0-23). |
|
day | Retorna o dia da semana da data, entre 1 (segunda-feira) e 7 (domingo). |
|
date | Retorna o dia do mês da data (1-31). |
|
week | Retorna a semana do ano conforme o padrão ISO da data (1-53). |
|
month | Retorna o mês da data (1-12). |
|
year | Retorna o ano da data. |
|
dateAdd | Adiciona um tempo à data.O argumento de unidade pode ser |
|
dateSubtract | Subtrai um tempo da data. O argumento de unidade pode ser |
|
dateBetween | Retorna a diferença entre duas datas. O argumento de unidade pode ser |
|
dateRange | Retorna um intervalo de datas formado pela data inicial e data final. |
|
dateStart | Retorna o início do intervalo de datas. |
|
dateEnd | Retorna o final do intervalo de datas. |
|
timestamp | Retorna o carimbo de data/hora Unix atual, representando a quantidade de milissegundos passados desde 1º de janeiro de 1970. |
|
fromTimestamp | Retorna a data do carimbo de data/hora Unix. O carimbo de data/hora representa a quantidade de milissegundos passados desde 1º de janeiro de 1970. Nota: a data retornada não armazenará os segundos e milissegundos. |
|
formatDate | Formata a data utilizando um formato personalizado. A sequência de formato pode conter o seguinte texto para representar partes da data: |
|
parseDate | Retorna a data conforme o padrão ISO 8601. |
|
name | Retorna o nome de uma pessoa. |
|
Retorna o endereço de e-mail de uma pessoa. |
| |
at | Retorna o valor de um índice especificado em uma lista. |
|
first | Retorna o primeiro item da lista. |
|
last | Retorna o último item da lista. |
|
slice | Retorna os itens da lista do índice inicial informado (inclusive) até o índice final (opcional e excludente). |
|
concat | Retorna a concatenação de várias listas. |
|
sort | Retorna a lista em ordem crescente. |
|
reverse | Retorna a lista em ordem reversa. |
|
join | Retorna os valores da lista com o conector entre os valores. |
|
split | Retorna a lista de valores criada separando uma entrada de texto com um separador. |
|
unique | Retorna a lista de valores únicos na lista de entrada. |
|
includes | Retorna "true" se a lista contiver o valor especificado; caso contrário, retorna "false". |
|
find | Retorna o primeiro item da lista para o qual a condição é verdadeira. |
|
findIndex | Retorna o índice do primeiro item da lista para o qual a condição é verdadeira. |
|
filter | Retorna os valores da lista para o qual a condição é verdadeira. |
|
some | Retorna "true" se algum item da lista satisfizer a condição; caso contrário, retorna "false". |
|
every | Retorna "true" se todos os itens da lista satisfizerem a condição; caso contrário, retorna "false". |
|
map | Retorna a lista preenchida com os resultados de chamar a expressão para cada item da lista de entradas. |
|
flat | Transforma uma lista de listas em uma única lista. |
|
id | Retorna o id da página. Se nenhuma página for fornecida, retorna o ID da página em que a fórmula está. |
|
equal | Retorna "true" se ambos os valores forem iguais; caso contrário, retorna "false". |
|
unequal | Retorna "false" se ambos os valores forem iguais; caso contrário, retorna "true". |
|
let | Atribui um valor a uma variável e avalia a expressão utilizando essa variável. |
|
lets | Atribui valores a diversas variáveis e avalia a expressão utilizando essas variáveis. |
|