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
| Parameter | Description |
|---|---|
| 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.
You can also use atEpoch() with a query that shows multiple time series, and compare it, for example, to another time series.
