Application.DStDev メソッド (Access)

指定したレコードセット (ドメイン) 内の母集団サンプル全体の標準偏差を推定します。

構文

式。DStDev (Expr,Domain, Criteria)

expressionApplication オブジェクトを 表す変数。

パラメーター

名前	必須 / オプション	データ型	説明
Expr	必須	String	標準偏差を計算する対象となる数値型フィールドを表す式です。 テーブルまたはクエリのフィールドを表す文字列式、またはそのフィールドの値を使用して計算を行う式を指定します。 expr では、テーブルのフィールド、フォームのコントロール、定数、または関数の名前を指定できます。 expr に関数が含まれている場合は、組み込み関数またはユーザー定義関数を使用できますが、別のドメイン集計関数や SQL 集計関数は使用できません。
ドメイン	必須	文字列型 (String)	定義域を構成するレコードセットを識別する文字列式。 パラメーターを必要としないクエリには、テーブル名またはクエリ名が指定できます。
Criteria	省略可能	バリアント型	DStDev 関数の対象となるデータの範囲を指定する省略可能な文字列式です。 たとえば、 criteria は多くの場合、SQL 式の WHERE 句と同じ役割を果たします (ただし WHERE という語は使用しません)。 引数 criteria を省略すると、DStDev 関数は定義域全体に対して expr を適用します。 criteria に含まれるフィールドが domain のフィールドでない場合、DStDev 関数は Null 値を返します。

戻り値

バリアント型

注釈

たとえば、モジュールで DStDev 関数を使用すると、学生の試験得点の標準偏差を計算できます。

domain が 2 つ未満のレコードを参照している場合、または条件を満たすレコードが 2 つ未満の場合、DStDev 関数は Null を返し、標準偏差を計算できないことを示します。

DStDev 関数を使用して、選択クエリの [抽出条件] 行で条件を指定します。 たとえば、[受注] テーブルと [商品] テーブルに対するクエリを作成し、運送料が平均値に標準偏差を加えたものよりも高くなるすべての商品を表示できます。 [フレート] フィールドの下の [抽出条件] 行には、次の式が含まれます。

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

クエリの計算フィールド式、または更新クエリの [Update To] 行で DStDev 関数を使用します。

注:

集計クエリの計算フィールド式では、 DStDev 関数と DStDevP 関数、または StDev 関数と StDevP 関数を使用します。 DStDev または DStDevP 関数を使用すると、データをグループ化する前に値が計算されます。 StDev または StDevP 関数を使用すると、データをグループ化してから値が計算されます。

DStDev 関数は、抽出条件を指定して関数を実行するデータ範囲を制限する必要があるときに、演算コントロールで使用します。 たとえば、カリフォルニア州に出荷される注文の標準偏差を表示するには、テキスト ボックスの ControlSource プロパティを次の式に設定します。

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

単純に domain のすべてのレコードの標準偏差を表示する場合は、StDev 関数または StDevP 関数を使用します。

expr で指定されたフィールドのデータ型が数値の場合、DStDev 関数は倍精度浮動小数点型 (Double) のデータを返します。 DStDev を演算コントロール内で使用する場合は、式にデータ型変換関数を組み込むと、パフォーマンスが向上します。

例

次の例では、愛知県に出荷された貨物を母集団または母集団標本と見なしてその標準偏差の概算値を求めます。 定義域は [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 & "'")

次の例では、DStDev 関数でさまざまな criteria の種類を使用する方法を示します。

    ' ***************************
    ' 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")
    ' ***************************

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。