Sum
Propósito
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 ).
•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... ).
Exemplos
Uma tabela Fatura tem um portal que mostra itens de linha.
Sum ( ItensdeLinha::PreçoEstendido ) totaliza os valores de todos os itens da fatura.
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.
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.
Nota 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.
Tópicos relacionados