Table of contents
TOC
Collapse the table of content
Expand the table of content

Var, VarP Functions (Microsoft Access SQL)

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

Applies to: Access 2013 | Access 2016

In this articleSyntaxRemarks Example

Return estimates of the variance for a population or a population sample represented as a set of values contained in a specified field on a query.

Syntax

Var(expr)

VarP(expr)

The expr placeholder represents a string expression identifying the field that contains the numeric data you want to evaluate or an expression that performs a calculation using the data in that field. Operands in expr can include the name of a table field, a constant, or a function (which can be either intrinsic or user-defined but not one of the other SQL aggregate functions).

Remarks

The VarP function evaluates a population, and the Var function evaluates a population sample.

If the underlying query contains fewer than two records, the Var and VarP functions return a Null value, which indicates that a variance cannot be calculated.

You can use the Var and VarP functions in a query expression or in an SQL statement.

Example

This example uses the Orders table to estimate the variance of freight costs for orders shipped to the United Kingdom.

This example calls the EnumFields procedure, which you can find in the SELECT statement example.

Sub VarX() 

    Dim dbs As Database, rst As Recordset 

    ' Modify this line to include the path to Northwind 
    ' on your computer. 
    Set dbs = OpenDatabase("Northwind.mdb") 

    ' Calculate the variance of freight costs for  
    ' orders shipped to the United Kingdom.  
    Set rst = dbs.OpenRecordset("SELECT " _ 
        &; "Var(Freight) " _ 
        &; "AS [UK Freight Variance] " _ 
        &; "FROM Orders WHERE ShipCountry = 'UK';") 

    ' Populate the Recordset. 
    rst.MoveLast 

    ' Call EnumFields to print the contents of the  
    ' Recordset. Pass the Recordset object and desired 
    ' field width. 
    EnumFields rst, 20 

    Debug.Print 

    Set rst = dbs.OpenRecordset("SELECT " _ 
        &; "VarP(Freight) " _ 
        &; "AS [UK Freight VarianceP] " _ 
        &; "FROM Orders WHERE ShipCountry = 'UK';") 

    ' Populate the Recordset. 
    rst.MoveLast 

    ' Call EnumFields to print the contents of the  
    ' Recordset. Pass the Recordset object and desired 
    ' field width. 
    EnumFields rst, 20 

    dbs.Close 

End Sub 

ACCESS SUPPORT RESOURCES
Access for developers forum on MSDN
Access help on support.office.com
Access help on answers.microsoft.com
Search for specific Access error codes on Bing
Access forums on UtterAccess
Access wiki on UtterAcess
Access developer and VBA programming help center (FMS)
Access posts on StackOverflow

© 2017 Microsoft