Função Avg (Microsoft Access SQL)Avg function (Microsoft Access SQL)

Aplica-se ao: Access 2013 | Access 2016Applies to: Access 2013 | Access 2016

Calcula a média aritmética de um conjunto de valores contidos em um campo específico de uma consulta.Calculates the arithmetic mean of a set of values contained in a specified field on a query.

SintaxeSyntax

Avg( expr )Avg( expr )

O espaço reservado expr representa uma expressão de cadeia de caracteres identifica o campo que contém dados numéricos que você deseja tirar a média ou uma expressão que executa um cálculo usando os dados desse campo.The expr placeholder represents a string expression identifying the field that contains the numeric data you want to average or an expression that performs a calculation using the data in that field. Os operandos em expr podem incluir o nome de um campo da tabela, uma constante ou uma função (que podem ser intrínsecos ou definidos pelo usuário, mas não uma das outras funções de agregação SQL).Operands in expr can include the name of a table field, a constant, or a function (which can be either intrinsic or user-defined but not one of the other SQL aggregate functions).

ComentáriosRemarks

A média calculada por Avg é a média aritmética (a soma dos valores divididos pelo número de valores).The average calculated by Avg is the arithmetic mean (the sum of the values divided by the number of values). Você pode usar Avg, por exemplo, para calcular o custo de frete médio.You could use Avg, for example, to calculate average freight cost.

A função Avg não inclui nenhum campo Null no cálculo.The Avg function does not include any Null fields in the calculation.

Use Avg em uma expressão de consulta e na propriedade SQL de um objeto QueryDef ou quando criar um objeto Recordset baseado em uma consulta SQL.You can use Avg in a query expression and in the SQL property of a QueryDef object or when creating a Recordset object based on an SQL query.

ExemploExample

Esse exemplo usa a tabela Orders para calcular a média dos encargos de frete de pedidos com cobranças de frete acima de US$ 100.This example uses the Orders table to calculate the average freight charges for orders with freight charges over $100.

Este exemplo chama o procedimento EnumFields, que você pode encontrar no exemplo de instrução SELECT.This example calls the EnumFields procedure, which you can find in the SELECT statement example.

Sub AvgX() 
 
    Dim dbs As Database, rst As Recordset 
 
    ' Modify this line to include the path to Northwind 
    ' on your computer. 
    Set dbs = OpenDatabase("Northwind.mdb") 
 
    ' Calculate the average freight charges for orders 
    ' with freight charges over $100.   
    Set rst = dbs.OpenRecordset("SELECT Avg(Freight)" _ 
        & " AS [Average Freight]" _ 
        & " FROM Orders WHERE Freight > 100;") 
    
    ' Populate the Recordset. 
    rst.MoveLast 
    
    ' Call EnumFields to print the contents of the  
    ' Recordset. Pass the Recordset object and desired 
    ' field width. 
    EnumFields rst, 25 
 
    dbs.Close 
 
End Sub

Confira tambémSee also

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.