Average
Retorna um valor que é a média de todos os valores válidos que não estão em branco em um campo.
Formato
Average ( 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
Originada na versão
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)
, independentemente de 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 Average retorna a média dos valores no primeiro campo de repetição, depois a média dos valores no segundo campo de repetição e assim por diante. Por isso, (1+5+6)/3=4;(2+6)/2=4;7/1=7;8/1=8.
Exemplo 1
Uma tabela Aluno tem um portal que mostra as pontuações de todos os exames de que o aluno participou. As pontuações do exame estão em uma tabela chamada Exames.
Average(Exames::Pontuação)
retorna a pontuação média do aluno de todos os exames de que ele participou.
Exemplo 2
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.
Average(Campo2)
retorna 6,5 quando o cálculo não é um campo de repetição.
Average(Campo1;Campo2;Campo3)
retorna 4, 4, 7, 8 quando o cálculo é um campo de repetição.