Referência > Referência de funções > Funções de agregação > Sum
 

Sum

Retorna o total de todos os valores válidos que não estão em branco em um campo.

Formato 

Sum(campo {; campo...})

Parâmetros 

campo - qualquer campo relacionado, campo de repetição ou conjunto de campos sem repetição; ou uma expressão que retorna um campo, campo de repetição ou conjunto de campos sem repetição.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

número

Originado em 

FileMaker Pro 6.0 ou anterior

Descrição 

Campo pode ser qualquer um dos seguintes:

um campo de repetição (campoDeRepetição).

um campo em registros relacionados correspondentes especificados por (tabela::campo), se esses registros aparecerem ou não em um portal.

vários campos sem repetição em um registro (campo1;campo2;campo3...).

repetições correspondentes de campos de repetição em um registro (campoDeRepetição1;campoDeRepetição2;campoDeRepetição3), se o resultado for retornado em um campo de repetição com pelo menos o mesmo número de repetições.

vários campos no primeiro registro correspondente especificados por (tabela::campo1;tabela::campo2;...). Você pode incluir campos de diferentes tabelas (tabela 1::campo A;tabela 2::campo B...).

Notas 

Quando um campo mencionado é um campo de repetição, a função Sum retorna a soma do primeiro campo de repetição, depois a soma do segundo campo de repetição e assim por diante.

Exemplo 1 

Uma tabela Fatura tem um portal que mostra itens de linha.

Sum(ItensdeLinha::PreçoEstendido) totaliza os valores de todos os itens da fatura.

Exemplo 2 

Uma tabela FaturamentoTempo tem um portal que mostra as horas trabalhadas em um projeto. Horas é um campo de tempo.

Sum(Horas::HorasFaturáveis) retorna o número total de horas faturáveis em um projeto. Dessa forma, se o portal mostrar 40 horas e 15:30 horas, o total de horas faturáveis será 55:30 ou 55 horas e meia.

Exemplo 3 

Nos seguintes exemplos:

Campo1 contém duas repetições com valores de 1 e 2.

Campo2 contém quatro repetições com valores de 5, 6, 7 e 8.

Campo3 contém 6.

Se o resultado do cálculo não for um campo de repetição:

Sum(Campo2) retorna 26.

Sum(Campo1;Campo2;Campo3) retorna 12.

Se o resultado do cálculo for um campo de repetição:

Sum(Campo2) retorna um campo de repetição com 26 na primeira repetição.

Sum(Campo1;Campo2;Campo3) retorna um campo de repetição com 12, 8, 7, 8.

Tópicos relacionados 

Referência de funções (lista de categorias)

Referência de funções (lista em ordem alfabética)

Sobre fórmulas

Sobre funções

Definição de campos de cálculo

Utilização de operadores em fórmulas