RunningAVG

Updated 2023-11-14 13:44:51.573000

Syntax

SELECT [westclintech].[wct].[RunningAVG] (
  <@Val, float,>
 ,<@RowNum, int,>
 ,<@Id, tinyint,>)

Description

Use the scalar function RunningAVG to calculate the average of column values in an ordered resultant table, without having to do a self-join. The average value is calculated for each value from the first value to the last value in the ordered group or partition. If the column values are presented to the functions out of order, an error message will be generated.

Arguments

@Id

a unique identifier for the RunningAVG calculation. @Id allows you to specify multiple RunningAVG calculation s within a resultant table. @Id is an expression of type tinyint or of a type that can be implicitly converted to tinyint.

@RowNum

the number of the row within the group for which the average is being calculated. If @RowNum for the current row in a set is less than or equal to the previous @RowNum and @RowNum is not equal to 1, an error message will be generated. @RowNum is an expression of type int or of a type that can be implicitly converted to int.

@Val

the value passed into the function. @Val is an expression of type float or of a type that can be implicitly converted to float.

Return Type

float

Remarks

If @Id is NULL then @Id = 0.

To calculate moving averages, use the MovingAVG function.

To calculate moving averages for time series, use the DEMA or DWMA function.

If @RowNum is equal to 1, RunningAVG is equal to @Val.

@RowNum must be in ascending order.

There may be cases where the order in which the data are returned to the function and the order in which the results are returned are different, generally due to parallelism. You can use OPTION(MAXDOP 1) or OPTION(MAXDOP 1,FORCE ORDER) to help eliminate this problem.

Examples

In this example we will calculate the average check amount in a check register from the first check to the last check. We will create a temporary table, #c, populate it with some data and then run the SELECT.

/*Create the temporary table*/

CREATE TABLE #c

(

    num_check int,

    date_check datetime,

    payee varchar(50),

    amt_check money,

    Primary Key (num_check)

);

/*Populate the table with some data*/

INSERT INTO #c

VALUES

(1200, '2012-01-31', 'Gas Company', 108.49);

INSERT INTO #c

VALUES

(1201, '2012-01-31', 'Electric Company', 98.27);

INSERT INTO #c

VALUES

(1202, '2012-01-31', 'Telephone Company', 136.6);

INSERT INTO #c

VALUES

(1203, '2012-01-31', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1204, '2012-01-31', 'Mortgage Bank', 1129.23);

INSERT INTO #c

VALUES

(1205, '2012-02-29', 'Gas Company', 153.89);

INSERT INTO #c

VALUES

(1206, '2012-02-29', 'Electric Company', 121.99);

INSERT INTO #c

VALUES

(1207, '2012-02-29', 'Telephone Company', 138.92);

INSERT INTO #c

VALUES

(1208, '2012-02-29', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1209, '2012-02-29', 'Mortgage Bank', 1129.23);

INSERT INTO #c

VALUES

(1210, '2012-03-31', 'Gas Company', 70.79);

INSERT INTO #c

VALUES

(1211, '2012-03-31', 'Electric Company', 93.57);

INSERT INTO #c

VALUES

(1212, '2012-03-31', 'Telephone Company', 149.78);

INSERT INTO #c

VALUES

(1213, '2012-03-31', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1214, '2012-03-31', 'Mortgage Bank', 1129.23);

INSERT INTO #c

VALUES

(1215, '2012-04-30', 'Gas Company', 105.58);

INSERT INTO #c

VALUES

(1216, '2012-04-30', 'Electric Company', 149.36);

INSERT INTO #c

VALUES

(1217, '2012-04-30', 'Telephone Company', 145.35);

INSERT INTO #c

VALUES

(1218, '2012-04-30', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1219, '2012-04-30', 'Mortgage Bank', 1129.23);

INSERT INTO #c

VALUES

(1220, '2012-05-31', 'Gas Company', 96.27);

INSERT INTO #c

VALUES

(1221, '2012-05-31', 'Electric Company', 114.62);

INSERT INTO #c

VALUES

(1222, '2012-05-31', 'Telephone Company', 145.43);

INSERT INTO #c

VALUES

(1223, '2012-05-31', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1224, '2012-05-31', 'Mortgage Bank', 1129.23);

INSERT INTO #c

VALUES

(1225, '2012-06-30', 'Gas Company', 147.03);

INSERT INTO #c

VALUES

(1226, '2012-06-30', 'Electric Company', 130.52);

INSERT INTO #c

VALUES

(1227, '2012-06-30', 'Telephone Company', 147.71);

INSERT INTO #c

VALUES

(1228, '2012-06-30', 'Car Leasing Company', 361.75);

INSERT INTO #c

VALUES

(1229, '2012-06-30', 'Mortgage Bank', 1129.23);

/*Calculate the running average*/

SELECT num_check,

       cast(convert(varchar, date_check, 106) as char(11)) as date_check,

       cast(payee as char(20)) as payee,

       amt_check,

       wct.RunningAvg(amt_check, num_check, NULL) as [Running AVG]

FROM #c;

This produces the following result.

{"columns":[{"field":"num_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"date_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"payee"},{"field":"amt_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Running AVG","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"num_check":"1200","date_check":"31 Jan 2012","payee":"Gas Company","amt_check":"108.49","Running AVG":"108.49"},{"num_check":"1201","date_check":"31 Jan 2012","payee":"Electric Company","amt_check":"98.27","Running AVG":"103.38"},{"num_check":"1202","date_check":"31 Jan 2012","payee":"Telephone Company","amt_check":"136.60","Running AVG":"114.453333333333"},{"num_check":"1203","date_check":"31 Jan 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"176.2775"},{"num_check":"1204","date_check":"31 Jan 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"366.868"},{"num_check":"1205","date_check":"29 Feb 2012","payee":"Gas Company","amt_check":"153.89","Running AVG":"331.371666666667"},{"num_check":"1206","date_check":"29 Feb 2012","payee":"Electric Company","amt_check":"121.99","Running AVG":"301.46"},{"num_check":"1207","date_check":"29 Feb 2012","payee":"Telephone Company","amt_check":"138.92","Running AVG":"281.1425"},{"num_check":"1208","date_check":"29 Feb 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"290.098888888889"},{"num_check":"1209","date_check":"29 Feb 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"374.012"},{"num_check":"1210","date_check":"31 Mar 2012","payee":"Gas Company","amt_check":"70.79","Running AVG":"346.446363636364"},{"num_check":"1211","date_check":"31 Mar 2012","payee":"Electric Company","amt_check":"93.57","Running AVG":"325.373333333333"},{"num_check":"1212","date_check":"31 Mar 2012","payee":"Telephone Company","amt_check":"149.78","Running AVG":"311.866153846154"},{"num_check":"1213","date_check":"31 Mar 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"315.429285714286"},{"num_check":"1214","date_check":"31 Mar 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"369.682666666667"},{"num_check":"1215","date_check":"30 Apr 2012","payee":"Gas Company","amt_check":"105.58","Running AVG":"353.17625"},{"num_check":"1216","date_check":"30 Apr 2012","payee":"Electric Company","amt_check":"149.36","Running AVG":"341.187058823529"},{"num_check":"1217","date_check":"30 Apr 2012","payee":"Telephone Company","amt_check":"145.35","Running AVG":"330.307222222222"},{"num_check":"1218","date_check":"30 Apr 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"331.962105263158"},{"num_check":"1219","date_check":"30 Apr 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"371.8255"},{"num_check":"1220","date_check":"31 May 2012","payee":"Gas Company","amt_check":"96.27","Running AVG":"358.70380952381"},{"num_check":"1221","date_check":"31 May 2012","payee":"Electric Company","amt_check":"114.62","Running AVG":"347.609090909091"},{"num_check":"1222","date_check":"31 May 2012","payee":"Telephone Company","amt_check":"145.43","Running AVG":"338.818695652174"},{"num_check":"1223","date_check":"31 May 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"339.774166666667"},{"num_check":"1224","date_check":"31 May 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"371.3524"},{"num_check":"1225","date_check":"30 Jun 2012","payee":"Gas Company","amt_check":"147.03","Running AVG":"362.724615384615"},{"num_check":"1226","date_check":"30 Jun 2012","payee":"Electric Company","amt_check":"130.52","Running AVG":"354.124444444445"},{"num_check":"1227","date_check":"30 Jun 2012","payee":"Telephone Company","amt_check":"147.71","Running AVG":"346.7525"},{"num_check":"1228","date_check":"30 Jun 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"347.269655172414"},{"num_check":"1229","date_check":"30 Jun 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"373.335"}]}

In this example, we calculate the average by payee in date order and use the ROW_NUMBER() function to determine the @RowNum value passed into the RunningAVG function.

SELECT num_check,

       cast(convert(varchar, date_check, 106) as char(11)) as date_check,

       cast(payee as char(20)) as payee,

       amt_check,

       wct.RunningAvg(amt_check, ROW_NUMBER() OVER (PARTITION BY payee ORDER BY 

                 payee, num_check), NULL) as [Running AVG]

FROM #c

ORDER BY payee,

         num_check;

This produces the following result.

{"columns":[{"field":"num_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"date_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"payee"},{"field":"amt_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Running AVG","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"num_check":"1203","date_check":"31 Jan 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1208","date_check":"29 Feb 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1213","date_check":"31 Mar 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1218","date_check":"30 Apr 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1223","date_check":"31 May 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1228","date_check":"30 Jun 2012","payee":"Car Leasing Company","amt_check":"361.75","Running AVG":"361.75"},{"num_check":"1201","date_check":"31 Jan 2012","payee":"Electric Company","amt_check":"98.27","Running AVG":"98.27"},{"num_check":"1206","date_check":"29 Feb 2012","payee":"Electric Company","amt_check":"121.99","Running AVG":"110.13"},{"num_check":"1211","date_check":"31 Mar 2012","payee":"Electric Company","amt_check":"93.57","Running AVG":"104.61"},{"num_check":"1216","date_check":"30 Apr 2012","payee":"Electric Company","amt_check":"149.36","Running AVG":"115.7975"},{"num_check":"1221","date_check":"31 May 2012","payee":"Electric Company","amt_check":"114.62","Running AVG":"115.562"},{"num_check":"1226","date_check":"30 Jun 2012","payee":"Electric Company","amt_check":"130.52","Running AVG":"118.055"},{"num_check":"1200","date_check":"31 Jan 2012","payee":"Gas Company","amt_check":"108.49","Running AVG":"108.49"},{"num_check":"1205","date_check":"29 Feb 2012","payee":"Gas Company","amt_check":"153.89","Running AVG":"131.19"},{"num_check":"1210","date_check":"31 Mar 2012","payee":"Gas Company","amt_check":"70.79","Running AVG":"111.056666666667"},{"num_check":"1215","date_check":"30 Apr 2012","payee":"Gas Company","amt_check":"105.58","Running AVG":"109.6875"},{"num_check":"1220","date_check":"31 May 2012","payee":"Gas Company","amt_check":"96.27","Running AVG":"107.004"},{"num_check":"1225","date_check":"30 Jun 2012","payee":"Gas Company","amt_check":"147.03","Running AVG":"113.675"},{"num_check":"1204","date_check":"31 Jan 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1209","date_check":"29 Feb 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1214","date_check":"31 Mar 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1219","date_check":"30 Apr 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1224","date_check":"31 May 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1229","date_check":"30 Jun 2012","payee":"Mortgage Bank","amt_check":"1129.23","Running AVG":"1129.23"},{"num_check":"1202","date_check":"31 Jan 2012","payee":"Telephone Company","amt_check":"136.60","Running AVG":"136.6"},{"num_check":"1207","date_check":"29 Feb 2012","payee":"Telephone Company","amt_check":"138.92","Running AVG":"137.76"},{"num_check":"1212","date_check":"31 Mar 2012","payee":"Telephone Company","amt_check":"149.78","Running AVG":"141.766666666667"},{"num_check":"1217","date_check":"30 Apr 2012","payee":"Telephone Company","amt_check":"145.35","Running AVG":"142.6625"},{"num_check":"1222","date_check":"31 May 2012","payee":"Telephone Company","amt_check":"145.43","Running AVG":"143.216"},{"num_check":"1227","date_check":"30 Jun 2012","payee":"Telephone Company","amt_check":"147.71","Running AVG":"143.965"}]}

In this example we calculate 2 running averages which we will call the month-to-date (MTD) running average and the year-to-date (YTD) running average.

SELECT num_check as [check],

       cast(convert(varchar, date_check, 106) as char(11)) as date_check,

       cast(payee as char(20)) as payee,

       amt_check,

       ROUND(wct.RunningAvg(amt_check, ROW_NUMBER() OVER (PARTITION BY MONTH(

                 date_check)ORDER BY num_check), 1), 2) as [MTD AVG],

       ROUND(wct.RunningAvg(amt_check, num_check, NULL), 2) as [YTD AVG]

FROM #c

ORDER BY num_check;

This produces the following result.

{"columns":[{"field":"check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"date_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"payee"},{"field":"amt_check","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"MTD AVG","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"YTD AVG","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"check":"1200","date_check":"31 Jan 2012","payee":"Gas Company","amt_check":"108.49","MTD AVG":"108.49","YTD AVG":"108.49"},{"check":"1201","date_check":"31 Jan 2012","payee":"Electric Company","amt_check":"98.27","MTD AVG":"103.38","YTD AVG":"103.38"},{"check":"1202","date_check":"31 Jan 2012","payee":"Telephone Company","amt_check":"136.60","MTD AVG":"114.45","YTD AVG":"114.45"},{"check":"1203","date_check":"31 Jan 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"176.28","YTD AVG":"176.28"},{"check":"1204","date_check":"31 Jan 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"366.87","YTD AVG":"366.87"},{"check":"1205","date_check":"29 Feb 2012","payee":"Gas Company","amt_check":"153.89","MTD AVG":"153.89","YTD AVG":"331.37"},{"check":"1206","date_check":"29 Feb 2012","payee":"Electric Company","amt_check":"121.99","MTD AVG":"137.94","YTD AVG":"301.46"},{"check":"1207","date_check":"29 Feb 2012","payee":"Telephone Company","amt_check":"138.92","MTD AVG":"138.27","YTD AVG":"281.14"},{"check":"1208","date_check":"29 Feb 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"194.14","YTD AVG":"290.1"},{"check":"1209","date_check":"29 Feb 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"381.16","YTD AVG":"74.01"},{"check":"1210","date_check":"31 Mar 2012","payee":"Gas Company","amt_check":"70.79","MTD AVG":"70.79","YTD AVG":"346.45"},{"check":"1211","date_check":"31 Mar 2012","payee":"Electric Company","amt_check":"93.57","MTD AVG":"82.18","YTD AVG":"325.37"},{"check":"1212","date_check":"31 Mar 2012","payee":"Telephone Company","amt_check":"149.78","MTD AVG":"104.71","YTD AVG":"311.87"},{"check":"1213","date_check":"31 Mar 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"168.97","YTD AVG":"315.43"},{"check":"1214","date_check":"31 Mar 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"361.02","YTD AVG":"369.68"},{"check":"1215","date_check":"30 Apr 2012","payee":"Gas Company","amt_check":"105.58","MTD AVG":"105.58","YTD AVG":"353.18"},{"check":"1216","date_check":"30 Apr 2012","payee":"Electric Company","amt_check":"149.36","MTD AVG":"127.47","YTD AVG":"341.19"},{"check":"1217","date_check":"30 Apr 2012","payee":"Telephone Company","amt_check":"145.35","MTD AVG":"133.43","YTD AVG":"330.31"},{"check":"1218","date_check":"30 Apr 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"190.51","YTD AVG":"331.96"},{"check":"1219","date_check":"30 Apr 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"378.25","YTD AVG":"371.83"},{"check":"1220","date_check":"31 May 2012","payee":"Gas Company","amt_check":"96.27","MTD AVG":"96.27","YTD AVG":"358.7"},{"check":"1221","date_check":"31 May 2012","payee":"Electric Company","amt_check":"114.62","MTD AVG":"105.44","YTD AVG":"347.61"},{"check":"1222","date_check":"31 May 2012","payee":"Telephone Company","amt_check":"145.43","MTD AVG":"118.77","YTD AVG":"338.82"},{"check":"1223","date_check":"31 May 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"179.52","YTD AVG":"339.77"},{"check":"1224","date_check":"31 May 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"369.46","YTD AVG":"371.35"},{"check":"1225","date_check":"30 Jun 2012","payee":"Gas Company","amt_check":"147.03","MTD AVG":"147.03","YTD AVG":"362.72"},{"check":"1226","date_check":"30 Jun 2012","payee":"Electric Company","amt_check":"130.52","MTD AVG":"138.78","YTD AVG":"354.12"},{"check":"1227","date_check":"30 Jun 2012","payee":"Telephone Company","amt_check":"147.71","MTD AVG":"141.75","YTD AVG":"346.75"},{"check":"1228","date_check":"30 Jun 2012","payee":"Car Leasing Company","amt_check":"361.75","MTD AVG":"196.75","YTD AVG":"347.27"},{"check":"1229","date_check":"30 Jun 2012","payee":"Mortgage Bank","amt_check":"1129.23","MTD AVG":"383.25","YTD AVG":"373.34"}]}