Funções DDesvP, DDesvPP

Pode utilizar as funções DDesvP e DDesvPP para estimar o desvio-padrão de um conjunto de valores num conjunto de registos especificado (um domínio (domínio: conjunto de registos definido por uma tabela, consulta ou expressão SQL. As funções de agregação de domínio devolvem informações estatísticas sobre um domínio específico ou um conjunto de registos.)). Utilize as funções DDesvP e DDesvPP num módulo do Visual Basic for Applications (VBA), numa macro (macro: acção ou conjunto de acções que podem ser utilizadas para automatizar tarefas. As macros são gravadas na linguagem de programação Visual Basic for Applications.), numa expressão de consulta ou num controlo calculado (controlo calculado: controlo utilizado num formulário, relatório ou página de acesso a dados para apresentar o resultado de uma expressão. O resultado é calculado de novo sempre que houver uma alteração em qualquer dos valores nos quais a expressão se baseia.) num formulário ou relatório.

Utilize a função DDesvPP para avaliar uma população e a função DDesvP para avaliar uma amostra da população.

Por exemplo, poderá utilizar a função DDesvP num módulo para calcular o desvio-padrão de resultados de testes de um conjunto de alunos.

Sintaxe

DDesvP(expr, domínio [, critérios] )

DDesvPP(expr, domínio [, critérios] )

As funções DDesvP e DDesvPP têm os seguintes argumentos:

Argumento Descrição
expr Obrigatório. Uma expressão que identifica o campo numérico em que pretende encontrar o desvio-padrão. Pode ser uma expressão da cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) que identifique um campo de uma tabela ou consulta ou uma expressão que efectue um cálculo dos dados nesse campo. No argumento expr, pode incluir o nome de um campo numa tabela, um controlo num formulário, uma constante ou uma função. Se o argumento expr incluir uma função, esta pode ser incorporada ou definida pelo utilizador, mas não outra função de domínio agregado ou de agregação SQL.
domínio Obrigatório. Uma expressão da cadeia que identifica o conjunto de registos que constituem o domínio. Pode ser o nome de uma tabela ou consulta para uma consulta que não necessite de um parâmetro.
critérios Opcional. Uma expressão da cadeia utilizada para restringir o intervalo de dados em que a função DDesvP ou DDesvPP é executada. Por exemplo, o argumento critérios é frequentemente equivalente à cláusula WHERE numa expressão SQL, sem a palavra WHERE. Se omitir o argumento critérios, as funções DDesvP e DDesvPP avaliam o argumento expr em relação a todo o domínio. Qualquer campo incluído em critérios também tem de ser um campo em domínio; caso contrário, as funções DDesvP e DDesvPP irão devolver um valor Nulo (Null: valor que pode ser introduzido num campo ou utilizado em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, tais como campos de chave primária, não podem conter um valor Null.).

Observações

Se o domínio se referir a menos de dois registos ou se menos de dois registos cumprirem os critérios, as funções DDesvP e DDesvPP devolvem um valor Nulo, a indicar que não é possível calcular um desvio-padrão.

Se utilizar a função DDesvP ou DDesvPP numa macro, módulo, expressão de consulta ou controlo calculado, terá de construir cuidadosamente o argumento critérios para garantir que o mesmo é avaliado correctamente.

Pode utilizar as funções DDesvP e DStDevP para especificar os critérios na linha Critérios de uma consulta selecção. Por exemplo, poderá criar uma consulta numa tabela Encomendas e numa tabela Produtos para apresentar todos os produtos para os quais o custo do transporte ficou acima da média somando o desvio-padrão do custo do transporte. A linha Critérios abaixo do campo Frete terá de conter a seguinte expressão:

>(DStDev("[Frete]", "Encomendas") + DMédia("[Frete]", "Encomendas"))
      

Pode utilizar as funções DDesvP e DDesvPP numa expressão de campo calculado numa consulta ou na linha Actualizar Para de uma consulta de actualização (consulta actualização: consulta de acção (instrução SQL) que altera um conjunto de registos de acordo com os critérios (condições de pesquisa) especificados pelo utilizador.).

 Nota   Pode utilizar as funções DDesvP e DDesvPP ou as funções DDesvP e DDesvPP numa expressão de campo calculado de uma consulta de totais (consulta de totais: consulta que apresenta um cálculo sumário, tal como uma média ou uma soma, para valores existentes em vários campos de uma ou mais tabelas. Uma consulta de totais não é um tipo separado de consulta; pelo contrário, pois permite expandir a flexibilidade das consultas de selecção.). Se utilizar a função DDesvP ou DDesvPP, os valores são calculados antes de os dados serem agrupados. Se utilizar a função DDesvP ou DDesvPP, os dados são agrupados antes de os valores na expressão do campo serem avaliados.

Utilize as funções DDesvP e DDesvPP num controlo calculado quando necessitar de especificar critérios para restringir o intervalo de dados em que a função é executada. Por exemplo, para visualizar o desvio-padrão de encomendas a expedir para o Porto, defina a propriedade OrigemDoControlo de uma caixa de texto com a seguinte expressão:

=DDesvP("[Frete]", "Encomendas", "[RegiãoDeEnvio] = 'CA'")
      

Se pretender simplesmente encontrar o desvio-padrão em todos os registos no domínio, utilize a função DDesvP ou DDesvPP.

MostrarSugestão

Se o tipo de dados do campo, a partir do qual o argumento expr é derivado, for um número, as funções DDesvP e DDesvPP devolvem um tipo de dados Duplo (tipo de dados Duplo: tipo de dados fundamental que contém números de vírgula flutuante de dupla precisão. É armazenado como um número de 64 bits com um valor entre cerca de -1,797E308 e -4,940E-324 (negativo), entre 4,94E-324 e 1,797E308 (positivo) e 0.). Se utilizar a função DDesvP ou DDesvPP num controlo calculado, inclua uma função de conversão do tipo de dados na expressão para melhorar o desempenho.

 Nota   As alterações não guardadas de registos no domínio não são incluídas quando utilizar estas funções. Se pretender que a função DDesvP ou DDesvPP se baseie nos valores alterados, primeiro tem de guardar as alterações clicando em Guardar Registo em Registos no separador Dados, movendo o foco para outro registo ou utilizando o método Actualizar.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

O exemplo seguinte devolve estimativas do desvio-padrão de uma população e de uma amostra da população para encomendas expedidas para o Reino Unido. O domínio é uma tabela Encomendas. O argumento critérios restringe o conjunto resultante de registos a registos em que o valor de PaísRegiãoDeDestino seja UK.

Dim dblX As Double
Dim dblY As Double

' Sample estimate.
dblX = DDesvP("[Frete]", "Encomendas", _
    "[PaísRegiãoDeDestino] = 'UK'")

' Population estimate.
dblY = DDesvPP("[Frete]", "Encomendas", _
    "[PaísRegiãoDeDestino] = 'UK'")
      

O exemplo seguinte calcula as mesmas estimativas utilizando uma variável strCountryRegion, no argumento critérios. Note que são incluídas aspas simples (') na expressão da cadeia, de forma a que quando as cadeias forem concatenadas, a cadeia literal UK seja colocada entre aspas simples.

Dim strCountryRegion As String
Dim dblX As Double
Dim dblY As Double

strCountryRegion = "UK"

dblX = DStDev("[Frete]", "Encomendas", _
    "[PaísRegiãoDeDestino] = '" & strCountryRegion & "'")

dblY = DStDevP("[Frete]", "Encomendas", _
    "[PaísRegiãoDeDestino] = '" & strCountryRegion & "'")
      
 
 
Aplica-se a:
Access 2007