Reference to the atEpoch() function

Summary

atEpoch(<epochTime>, <tsExpression>)

Returns the value at the specified time for the time series described by the expression. The returned value is displayed continuously across the chart, so you can use it as a reference value for comparing against the results of other queries of you can compare results at precise times.

Parameters

ParameterDescription
epochTime The report time of the data value to be returned, as Epoch time in seconds.
tsExpression Expression that describes the time series to return a data value from.

Description

The atEpoch() standard time function returns the data value that was reported at a particular time by the time series described by the expression. The returned value is displayed continuously across the chart, so you can use it as a reference value for comparing against the results of other queries. atEpoch() returns a separate result for each time series described by the expression.

You designate the data value of interest by specifying the time it was reported.

The at() function offers several other ways to report data at a specific time.

Examples

Here’s a query that shows the value for a single source at Epoch time 1571177581. atEpoch for 1 source

You can also use atEpoch() with a query that shows multiple time series, and compare it, for example, to another time series.

at Epoch for multiple sources