Introdução às fórmulas e funções do SharePoint

Aplica-se a
SharePoint Server 2019 SharePoint Server 2016 SharePoint Server 2013 Standard SharePoint Server 2010 Windows SharePoint Services 3.0

Pode utilizar fórmulas e funções em listas ou bibliotecas para calcular dados de várias formas. Ao adicionar uma coluna calculada a uma lista ou biblioteca, pode criar uma fórmula que inclui dados de outras colunas e executa funções para calcular datas e horas, equações matemáticas ou manipular texto. Por exemplo, numa lista de tarefas, pode utilizar uma coluna para calcular o número de dias necessários para concluir cada tarefa, com base nas colunas Data de Início e Data de Conclusão.

Observação

Este artigo descreve os conceitos básicos relacionados com a utilização de fórmulas e funções. Para obter informações específicas sobre uma determinada função, consulte o artigo sobre essa função.

Neste artigo

Descrição geral das fórmulas

As fórmulas são equações que executam cálculos com valores numa lista ou biblioteca. A fórmula tem início com um sinal de igual (=). Por exemplo, a fórmula seguinte multiplica 2 por 3 e, em seguida, adiciona 5 ao resultado.

=5+2*3

Pode utilizar uma fórmula numa coluna calculada e calcular os valores predefinidos de uma coluna. Uma fórmula pode conter funções, referências de coluna, operadores e constantes, como no exemplo seguinte.

=PI()*[Result]^2

Elemento Descrição
Função A função PI() devolve o valor de pi: 3,141592654.
Referência (ou nome da coluna) [Resultado] representa o valor na coluna Resultado da linha atual.
Constante Números ou valores de texto introduzidos diretamente numa fórmula, como 2.
Operador O operador * (asterisco) multiplica e o operador ^ (acento circunflexo) eleva um número a uma potência.

Uma fórmula pode utilizar um ou mais dos elementos da tabela anterior. Eis alguns exemplos de fórmulas (por ordem de complexidade).

Fórmulas simples (como =128+345)

As fórmulas seguintes contêm constantes e operadores.

Exemplo Descrição
=128+345 Soma 128 e 345
=5^2 Praças 5

Fórmulas que contêm referências de coluna (como =[Receita], >[Custo])

As fórmulas seguintes referem-se a outras colunas na mesma lista ou biblioteca.

Exemplo Descrição
=[Receita] Utiliza o valor na coluna Receita.
=[Receita]*10/100 10% do valor na coluna Receita.
=[Receita] > [Custo] Devolve Sim se o valor na coluna Receita for maior que o valor na coluna Custo.

Fórmulas que chamam funções (como =MÉDIA(1; 2; 3; 4; 5))

As seguintes fórmulas chamam funções incorporadas.

Exemplo Descrição
=MÉDIA(1; 2; 3; 4; 5) Devolve a média de um conjunto de valores.
=MÁXIMO([Q1]; [Q2]; [Q3]; [Q4]) Retorna o valor máximo de um conjunto de valores.
=SE([Custo]>[Receita], "Não OK","OK") Devolve Não OK se o custo for superior à receita. Caso contrário, devolve OK.
=DIA("15-abr-2008") Devolve a parte do dia de uma data. Esta fórmula devolve o número 15.

Fórmulas com funções aninhadas (como =SOMA(SE([A][>B], [A]-[B], 10), [C]))

As fórmulas seguintes especificam uma ou mais funções como argumentos de função.

Exemplo Descrição
=SOMA(SE([A][>B], [A]-[B], 10), [C]) A função SE devolve a diferença entre os valores nas colunas A e B ou 10.
A função SOMA adiciona o valor devolvido pela função SE e o valor na coluna C.
=GRAUS(PI()) A função PI devolve o número 3,141592654.
A função GRAUS converte um valor especificado em radianos em graus. Esta fórmula devolve o valor 180.
=ÉNÚM(PROCURAR("BD",[Coluna1])) A função LOCALIZAR procura a cadeia BD na Coluna1 e devolve a posição inicial da cadeia. Devolve um valor de erro se a cadeia não for encontrada.
A função É.NÚM devolve Sim se a função LOCALIZAR devolver um valor numérico. Caso contrário, devolve Não.

Início da Página

Descrição geral das funções

Funções são fórmulas predefinidas que efetuam cálculos usando valores específicos, denominados argumentos, em uma determinada ordem ou estrutura. As funções podem ser usadas para executar cálculos simples ou complexos. Por exemplo, a seguinte instância da função ARRED arredonda um número na coluna Custo para duas casas decimais.

=ROUND([Cost], 2)

O vocabulário seguinte é útil quando está a aprender funções e fórmulas:

Estrutura A estrutura de uma função começa com um sinal de igual (=), seguido do nome da função, um parêntesis de abertura, os argumentos da função separados por vírgulas e um parêntese de fecho.

Nome da função Este é o nome de uma função suportada por listas ou bibliotecas. Cada função obtém um número específico de argumentos, processa-os e devolve um valor.

Argumentos Os argumentos podem ser números, texto, valores lógicos como Verdadeiro ou Falso ou referências de coluna. O argumento que indicar deve produzir um valor válido para esse argumento. Os argumentos também podem ser constantes, fórmulas ou outras funções.

Em determinados casos, talvez seja necessário usar uma função como um dos argumentos de outra função. Por exemplo, a fórmula que se segue utiliza uma função MÉDIA aninhada e compara o resultado com a soma de dois valores de coluna.

=AVERAGE([Cost1], SUM([Cost2]+[Discount]))

Devoluções válidas Quando uma função é utilizada como um argumento, tem de devolver o mesmo tipo de valor utilizado pelo argumento. Por exemplo, se o argumento utilizar Sim ou Não, a função aninhada tem de devolver Sim ou Não. Se isto não acontecer, a lista ou biblioteca apresenta um #VALUE! valor de erro.

Aninhamento dos limites dos níveis Uma fórmula pode conter até oito níveis de funções aninhadas. Quando a Função B é usada como argumento na Função A, a Função B é uma função de segundo nível. No exemplo acima, por exemplo, a função SOMA é uma função de segundo nível porque é um argumento da função MÉDIA. Uma função aninhada dentro da função SOMA seria uma função de terceiro nível e assim por diante.

Observação

  • Listas e bibliotecas não dão suporte às funções ALEATÓRIO e AGORA.
  • As funções HOJE e EU não têm suporte em colunas calculadas, mas têm suporte na configuração de valor padrão de uma coluna.

Início da Página

Usando referências de coluna em uma fórmula

Uma referência identifica uma célula na linha atual e indica a uma lista ou biblioteca onde procurar os valores ou dados que você deseja usar em uma fórmula. Por exemplo, [Cost] faz referência ao valor na coluna Cost na linha atual. Se a coluna Custo tiver o valor de 100 para a linha atual, =[Custo]*3 retornará 300.

Com referências, você pode usar os dados contidos em colunas diferentes de uma lista ou biblioteca em uma ou mais fórmulas. Colunas dos seguintes tipos de dados podem ser referenciadas em uma fórmula: linha única de texto, número, moeda, data e hora, escolha, sim/não e calculado.

Você usa o nome de exibição da coluna para fazer referência a ela em uma fórmula. Se o nome incluir um espaço ou um caractere especial, você deverá colocá-lo entre colchetes ([ ]). As referências não diferenciam maiúsculas de minúsculas. Por exemplo, você pode fazer referência à coluna Preço Unitário em uma fórmula como [Preço Unitário] ou [preço unitário].

Observação

  • Você não pode fazer referência a um valor em uma linha que não seja a linha atual.
  • Você não pode fazer referência a um valor em outra lista ou biblioteca.
  • Você não pode fazer referência à ID de uma linha para uma linha recém-inserida. A ID ainda não existe quando o cálculo é executado.
  • Você não pode fazer referência a outra coluna em uma fórmula que cria um valor padrão para uma coluna.

Início da Página

Usando constantes em uma fórmula

Uma constante é um valor que não é calculado. Por exemplo, a data 09/10/2008, o número 210 e o texto "Receitas trimestrais" são todos constantes. As constantes podem ser dos seguintes tipos de dados:

  • string (exemplo: =[sobrenome] = "Smith")
    As constantes de cadeia de caracteres são colocadas entre aspas e podem incluir até 255 caracteres.
  • Número (Exemplo: =[Custo] >= 29,99)
    As constantes numéricas podem incluir casas decimais e podem ser positivas ou negativas.
  • Data (exemplo: =[Data] > DATA(2007;7;1))
    As constantes de data requerem o uso da função DATE(year,month,day).
  • Booleano (exemplo: =IF([Cost]>[Revenue], "loss", "No loss")
    Sim e Não são constantes booleanas. Você pode usá-las em expressões condicionais. No exemplo acima, se Custo for maior que Receita, a função SE retornará Sim e a fórmula retornará a cadeia de caracteres "Perda". Se Custo for igual ou menor que Receita, a função retornará Não e a fórmula retornará a cadeia de caracteres "Sem Perda".

Início da Página

Usando operadores de cálculo em uma fórmula

Os operadores especificam o tipo de cálculo que você deseja efetuar nos elementos de uma fórmula. Listas e bibliotecas oferecem suporte a três tipos diferentes de operadores de cálculo: aritmética, comparação e texto.

Operadores aritméticos

Use os operadores aritméticos a seguir para realizar operações matemáticas básicas, como adição, subtração ou multiplicação; combinar números; ou para produzir resultados numéricos.

Operador aritmético Significado (exemplo)
+ (sinal de adição) Adição (3+3)
– (sinal de menos) Subtração (3–1)
Negação (–1)
* (asterisco) Multiplicação (3*3)
/ (sinal de divisão) Divisão (3/3)
% (sinal de porcentagem) Porcentagem (20%)
^ (acento circunflexo) Exponenciação (3^2)

Operadores de comparação

Você pode comparar dois valores, usando os operadores a seguir. Quando comparamos dois valores usando esses operadores, o resultado é um valor lógico de Sim ou Não.

Operador de comparação Significado (exemplo)
= (sinal de igual) Igual a (A=B)
> (sinal de maior que) Maior que (A>B)
< (sinal de menor que) Menor que (A<B)
>= (sinal de maior ou igual a) Maior ou igual a (A>=B)
<= (sinal de menor ou igual a) Menor ou igual a (A<=B)
<> (sinal de diferente de) Diferente de (A<>B)

Operador de texto

Use o e comercial (&) para unir ou concatenar uma ou mais cadeias de caracteres de texto para produzir uma única parte do texto.

Operador de texto Significado (exemplo)
& (E comercial) Conecta ou concatena dois valores para produzir um valor de texto contínuo ("North"&"wind")

Ordem em que uma lista ou biblioteca executa operações em uma fórmula

As fórmulas calculam valores segundo uma ordem específica. Uma fórmula pode começar com um sinal de igual (=). Seguindo o sinal de igual estão os elementos a serem calculados (os operandos), que são separados por operadores de cálculo. Listas e bibliotecas calculam a fórmula da esquerda para a direita, de acordo com uma ordem específica para cada operador na fórmula.

Precedência de operadores

Se você combinar vários operadores em uma única fórmula, listas e bibliotecas executarão as operações na ordem mostrada na tabela a seguir. Se uma fórmula contiver operadores com a mesma precedência — por exemplo, se uma fórmula contiver um operador de multiplicação e um operador de divisão — listas e bibliotecas avaliarão os operadores da esquerda para a direita.

Operador Descrição
Negação (como em –1)
% Porcentagem
^ Exponenciação
* e / Multiplicação e divisão
+ e – Adição e subtração
& Concatenação (conecta duas cadeias de caracteres de texto)
= <><= >= <> Comparação

Uso de parâmetros

Para alterar a ordem de avaliação, coloque entre parênteses a parte da fórmula que deve ser calculada primeiro. Por exemplo, a fórmula a seguir produz 11 porque uma lista ou biblioteca calcula a multiplicação antes da adição. A fórmula multiplica 2 por 3 e, em seguida, soma 5 ao resultado.

=5+2*3

Por outro lado, se você usar parênteses para alterar a sintaxe, a lista ou biblioteca adicionará 5 e 2 e multiplicará o resultado por 3 para produzir 21.

=(5+2)*3

No exemplo abaixo, os parênteses em torno da primeira parte da fórmula forçam a lista ou biblioteca a calcular [Custo]+25 primeiro e depois dividir o resultado pela soma dos valores nas colunas EC1 e EC2.

=([Cost]+25)/SUM([EC1]+[EC2])

Início da Página