Application.DStDevP メソッド (Access)
指定したレコードセット (ドメイン) 内の母集団全体の標準偏差を推定します。
構文
式。DStDevP (Expr,Domain, Criteria)
expressionApplication オブジェクトを 表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| Expr | 必須 | String | 標準偏差を計算する対象となる数値型フィールドを表す式です。 テーブルまたはクエリのフィールドを表す文字列式、またはそのフィールドの値を使用して計算を行う式を指定します。 expr では、テーブルのフィールド、フォームのコントロール、定数、または関数の名前を指定できます。 expr に関数が含まれている場合は、組み込み関数またはユーザー定義関数を使用できますが、別のドメイン集計関数や SQL 集計関数は使用できません。 |
| ドメイン | 必須 | 文字列型 (String) | 定義域を構成するレコードセットを識別する文字列式。 パラメーターを必要としないクエリには、テーブル名またはクエリ名が指定できます。 |
| Criteria | 省略可能 | バリアント型 | DStDevP 関数の対象となるデータの範囲を指定する省略可能な文字列式です。 たとえば、 criteria は多くの場合、SQL 式の WHERE 句と同じ役割を果たします (ただし WHERE という語は使用しません)。 引数 criteria を省略すると、DStDevP 関数は定義域全体に対して expr を適用します。 criteria に含まれるフィールドは domain のフィールドである必要があり、異なる場合は、DStDevP 関数は Null 値を返します。 |
戻り値
バリアント型
注釈
ドメインが 2 つ未満のレコードを参照している場合、または条件を満たすレコードが 2 つ未満の場合、DStDevP 関数は Null を返し、標準偏差を計算できないことを示します。
DStDevP 関数を使用して、選択クエリの [抽出条件] 行で条件を指定します。 たとえば、[受注] テーブルと [商品] テーブルに対するクエリを作成し、運送料が平均値に標準偏差を加えたものよりも高くなるすべての商品を表示できます。
クエリの計算フィールド式、または更新クエリの [Update To] 行で DStDevP 関数を使用します。
注:
集計クエリの計算フィールド式では、 DStDev 関数と DStDevP 関数、または StDev 関数と StDevP 関数を使用します。 DStDev または DStDevP 関数を使用すると、データをグループ化する前に値が計算されます。 StDev または StDevP 関数を使用すると、データをグループ化してから値が計算されます。
DStDev 関数は、抽出条件を指定して関数を実行するデータ範囲を制限する必要があるときに、演算コントロールで使用します。
単純に domain のすべてのレコードの標準偏差を表示する場合は、StDev 関数または StDevP 関数を使用します。
expr で指定されたフィールドのデータ型が数値の場合、DStDevP 関数は倍精度浮動小数点型 (Double) のデータを返します。 DStDevP を演算コントロール内で使用する場合、処理を高速化するには、式にデータ型変換関数を組み込みます。
例
次の例では、愛知県に出荷された貨物を母集団または母集団標本と見なしてその標準偏差の概算値を求めます。 定義域は [Orders] テーブルです。 引数 criteria により、[出荷先都道府県] が愛知県であるレコードが演算の対象になります。
Dim dblX As Double
Dim dblY As Double
' Sample estimate.
dblX = DStDev("[Freight]", "Orders", "[ShipCountry] = 'UK'")
' Population estimate.
dblY = DStDevP("[Freight]", "Orders", "[ShipCountry] = 'UK'")
次の例では、criteria 引数で 変数strCountryを使用して、同じ推定値を計算します。 文字列式には単一引用符 (') が含まれているため、文字列を連結すると、文字列リテラル UK は単一引用符で囲まれます。
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 & "'")
以下の例は、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")
' ***************************
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。