Méthode Application.DStDevP (Access)

Article
04/07/2023

Estime l’écart type au sein d’une population dans un jeu d’enregistrements spécifié (un domaine).

Syntaxe

expression. DStDevP (Expr, Domain, Criteria)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Expr	Obligatoire	String	Expression qui identifie le champ numérique dont vous voulez trouver l'écart type. Il peut s'agir d'une expression chaîne identifiant un champ dans une table ou une requête, ou d'une expression qui effectue un calcul sur les données de ce champ. Dans expr, vous pouvez inclure le nom d'un champ de table, un contrôle de formulaire, une constante ou une fonction. Si expr inclut une fonction, elle peut être intégrée ou définie par l’utilisateur, mais pas une autre fonction d’agrégation de domaine ou SQL.
Domaine	Obligatoire	Chaîne	Expression chaîne identifiant les enregistrements qui constituent le domaine. Il peut s'agir d'un nom de table ou d'un nom de requête qui ne requiert aucun paramètre.
Criteria	Facultatif	Variant	Expression chaîne facultative servant à limiter la plage des données sur laquelle porte la fonction DStDevP. Par exemple, criteria est souvent équivalent à la clause WHERE d'une expression SQL sans le mot WHERE. En cas d'omission de critère, la fonction DStDevP évalue expr par rapport à l'intégralité du domaine. Chaque champ compris dans critère doit aussi l'être dans domaine, sans quoi la fonction DStDevP renvoie la valeur Null.

Valeur renvoyée

Variant

Remarques

Si domaine fait référence à moins de deux enregistrements, ou si moins de deux enregistrements répondent à des critères, la fonction DStDevP retourne une valeur Null, indiquant qu’un écart type ne peut pas être calculé.

Utilisez la fonction DStDevP pour spécifier des critères dans la ligne Critères d’une requête select. Par exemple, créez une requête fondée sur une table Orders et une table Products pour afficher tous les produits dont le coût du port a été supérieur à la moyenne plus l'écart type du coût du port.

Utilisez la fonction DStDevP dans une expression de champ calculé d’une requête ou dans la ligne Mettre à jour vers d’une requête de mise à jour.

Remarque

Utilisez les fonctions DStDev et DStDevP ou les fonctions StDev et StDevP dans une expression de champ calculé d’une requête de totaux. Avec la fonction DStDev ou DStDevP, les valeurs sont calculées avant le regroupement des données. Avec la fonction StDev ou StDevP, les données sont regroupées avant l'évaluation des valeurs de l'expression de champ.

Utilisez la fonction DStDev dans un contrôle calculé, lorsque vous devez déterminer des critères visant à limiter la plage des données sur laquelle porte la fonction.

Si vous souhaitez simplement trouver l'écart type de tous les enregistrements dans le domaine, utilisez la fonction StDev ou StDevP.

Si le type de données du champ sur lequel est fondé expr est un nombre, la fonction DStDevP renvoie un type de données Double. Si vous utilisez la fonction DStDevP dans un contrôle calculé, insérez une fonction de conversion de type de données dans l'expression pour en améliorer les performances.

Exemple

L'exemple qui suit retourne des estimations de l'écart type d'une population et d'un échantillon de population pour les commandes livrées au Royaume-Uni. Le domaine consiste en la table Orders. L'argument critère limite le jeu d'enregistrements à ceux pour lesquels ShipCountry (Pays livraison) est UK (Royaume-Uni).

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

L’exemple suivant calcule les mêmes estimations à l’aide de la variable strCountry dans l’argument critère . Notez que les guillemets simples (') sont inclus dans l’expression de chaîne, de sorte que lorsque les chaînes sont concaténées, le littéral UK de chaîne est placé entre guillemets 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 & "'")

Les exemples suivants montrent comment utiliser différents types de critères avec la fonction DStDevP .

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

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

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

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

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

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

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partage via