docs-v2/content/v2.0/reference/flux/stdlib/built-in/transformations/timedmovingaverage.md

title	description	aliases	menu	weight	related
timedMovingAverage() function	The `timedMovingAverage()` function calculates the mean of values in a defined time range at a specified frequency.	/v2.0/reference/flux/functions/built-in/transformations/aggregates/timedmovingaverage/ /v2.0/reference/flux/stdlib/built-in/transformations/aggregates/timedmovingaverage/	v2_0_ref name parent timedMovingAverage built-in-transformations	402	/v2.0/reference/flux/stdlib/built-in/transformations/movingaverage/ /v2.0/reference/flux/stdlib/built-in/transformations/exponentialmovingaverage/ /v2.0/reference/flux/stdlib/built-in/transformations/doubleema/ /v2.0/reference/flux/stdlib/built-in/transformations/tripleema/ https://docs.influxdata.com/influxdb/latest/query_language/functions/#moving-average, InfluxQL MOVING_AVERAGE()

The timedMovingAverage() function calculates the mean of values in a defined time range at a specified frequency.

Function type: Transformation

timedMovingAverage(
  every: 1d,
  period: 5d,
  column="_value"
)

Parameters

every

The frequency of time windows.

Data type: Duration

period

The length of each averaged time window. A negative duration indicates start and stop boundaries are reversed.

Data type: Duration

column

The column used to compute the moving average. Defaults to "_value".

Data type: String

Examples

Calculate a seven day moving average every day

from(bucket: "example-bucket"):
  |> range(start: -7y)
  |> filter(fn: (r) =>
    r._measurement == "financial" and
    r._field == "closing_price"
  )
  |> timedMovingAverage(every: 1y, period: 5y)

Calculate a five year moving average every year

from(bucket: "example-bucket"):
  |> range(start: -50d)
  |> filter(fn: (r) =>
    r._measurement == "financial" and
    r._field == "closing_price"
  )
  |> timedMovingAverage(every: 1d, period: 7d)

Function definition

timedMovingAverage = (every, period, column="_value", tables=<-) =>
  tables
    |> window(every: every, period: period)
    |> mean(column:column)
    |> duplicate(column: "_stop", as: "_time")
    |> window(every: inf)