Método Application.DStDev (Access)

Calcula la desviación estándar en una muestra de población en un conjunto especificado de registros (un dominio).

Sintaxis

expresión. DStDev (Expr, Domain, Criteria)

expresión Variable que representa un objeto Application.

Parámetros

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Expr	Obligatorio	String	Expresión que identifica el campo numérico en el que desea obtener la desviación estándar. Puede ser una expresión de cadena que identifica un campo de una tabla o consulta, o bien, una expresión que realiza un cálculo con los datos de ese campo. En expr, puede incluir el nombre de un campo en una tabla, un control de un formulario, una constante o una función. Si expr incluye una función, puede ser integrada o definida por el usuario, pero no otra función de agregado de dominio o de agregado de SQL.
Dominio	Obligatorio	String	Una expresión de cadena que identifica el conjunto de registros que constituyen el dominio. Puede ser un nombre de tabla o de consulta para una consulta que no requiere ningún parámetro.
Criteria	Opcional	Variant	Expresión de cadena opcional que se utiliza para restringir el intervalo de datos con el que se ejecuta la función DStDev. Por ejemplo, criteria suele ser equivalente a la cláusula WHERE en una expresión SQL, sin la palabra WHERE. Si se omite criteria, la función DStDev evalúa expr para todo el dominio. Cualquier campo que se incluya en criteria debe ser también un campo de domain; de lo contrario, la función DStDev devolverá un valor Null.

Valor devuelto

Variant

Comentarios

Por ejemplo, puede usar la función DStDev en un módulo para calcular la desviación estándar de los resultados de los exámenes de un grupo de estudiantes.

Si dominio hace referencia a menos de dos registros, o si menos de dos registros cumplen los criterios, la función DStDev devuelve un valor Null, lo que indica que no se puede calcular una desviación estándar.

Use la función DStDev para especificar criterios en la fila Criterios de una consulta de selección. Por ejemplo, puede crear una consulta en una tabla Pedidos y en una tabla Productos para mostrar todos los productos cuyos gastos de envío queden por encima de la media más la desviación estándar de los gastos de envío. La fila Criteria situada debajo del campo Freight contendrá la siguiente expresión:

>(DStDev("[Freight]", "Orders") + DAvg("[Freight]", "Orders"))

Use la función DStDev en una expresión de campo calculada de una consulta o en la fila Actualizar a de una consulta de actualización.

Nota:

Use las funciones DStDev y DStDevP o las funciones StDev y StDevP en una expresión de campo calculada de una consulta de totales. Si usa la función DStDev o DStDevP, los valores se calculan antes de que se agrupen los datos. Si usa la función StDev o StDevP, los datos se agrupan antes de que se evalúen los valores de la expresión de campo.

Use la función DStDev en un control calculado cuando necesite especificar criterios para restringir el intervalo de datos con el que se ejecuta la función. Por ejemplo, para mostrar la desviación estándar de los pedidos que se enviarán a California, establezca la propiedad ControlSource de un cuadro de texto en la siguiente expresión:

=DStDev("[Freight]", "Orders", "[ShipRegion] = 'CA'")

Si simplemente desea obtener la desviación estándar de todos los registros de domain, use la función StDev o StDevP.

Si el tipo de datos del campo del que se deriva expr es un número, la función DStDev devuelve un tipo de datos Double. Si utiliza la función DStDev en un control calculado, incluya una función de conversión de tipo de datos en la expresión para mejorar el rendimiento.

Ejemplo:

En el siguiente ejemplo se devuelven estimaciones de la desviación estándar para una población y una muestra de población para los pedidos enviados al Reino Unido. El dominio es la tabla Orders. El argumento criteria restringe el conjunto de registros resultante a aquéllos para los que ShipCountry es igual a UK.

Dim dblX As Double 
Dim dblY As Double 
 
' Sample estimate. 
dblX = DStDev("[Freight]", "Orders", "[ShipCountry] = 'UK'") 
 
' Population estimate. 
dblY = DStDevP("[Freight]", "Orders", "[ShipCountry] = 'UK'")

En el siguiente ejemplo se calculan las mismas estimaciones mediante la variable strCountry en el argumento criteria . Tenga en cuenta que las comillas simples (') se incluyen en la expresión de cadena, de modo que cuando se concatenan las cadenas, el literal UK de cadena se incluirá entre comillas simples.

Dim strCountry As String 
Dim dblX As Double 
Dim dblY As Double 
 
strCountry = "UK" 
 
dblX = DStDev("[Freight]", "Orders", _ 
    "[ShipCountry] = '" & strCountry & "'") 
 
dblY = DStDevP("[Freight]", "Orders", _ 
    "[ShipCountry] = '" & strCountry & "'")

En los ejemplos siguientes se muestra cómo usar varios tipos de criterios con la función DStDev .

    ' ***************************
    ' Typical Use
    ' Numerical values. Replace "number" with the number to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = number")

    ' Strings.
    ' Numerical values. Replace "string" with the string to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria]= 'string'")

    ' Dates. Replace "date" with the string to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria]= #date#")
    ' ***************************

    ' ***************************
    ' Referring to a control on a form
    ' Numerical values
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = " & Forms!FormName!ControlName)

    ' Strings
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = '" & Forms!FormName!ControlName & "'")

    ' Dates
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = #" & Forms!FormName!ControlName & "#")
    ' ***************************

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DStDev("[FieldName]", "TableName", "[Criteria1] = " & Forms![FormName]![Control1] _
             & " AND [Criteria2] = '" & Forms![FormName]![Control2] & "'" _
            & " AND [Criteria3] =#" & Forms![FormName]![Control3] & "#")
    
    ' Use two fields from a single record.
    variable = DStDev("[LastName] & ', ' & [FirstName]", "tblPeople", "[PrimaryKey] = 7")
            
    ' Expressions
    variable = DStDev("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")
    
    ' Control Structures
    variable = DStDev("IIf([LastName] Like 'Smith', 'True', 'False')", "tableName", "[PrimaryKey] = 7")
    ' ***************************

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.