ContextQMD
Back to Influxdb

promql.timestamp() function

content/flux/v0/stdlib/internal/promql/timestamp.md

latest2.9 KB
Original Source
<!------------------------------------------------------------------------------ IMPORTANT: This page was generated from comments in the Flux source code. Any edits made directly to this page will be overwritten the next time the documentation is generated. To make updates to this documentation, update the function comments above the function definition in the Flux source code: https://github.com/influxdata/flux/blob/master/stdlib/internal/promql/promql.flux#L230-L230 Contributing to Flux: https://github.com/influxdata/flux#contributing Fluxdoc syntax: https://github.com/influxdata/flux/blob/master/docs/fluxdoc.md ------------------------------------------------------------------------------->

promql.timestamp() implements functionality equivalent to PromQL's timestamp() function.

Important: The internal/promql package is not meant for external use.

Function type signature
js
(<-tables: stream[{A with _value: float}]) => stream[{A with _value: float}]

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

tables

Input data. Defaults is piped-forward data (<-).

Examples

Convert timestamps into seconds since the Unix epoch

js
import "internal/promql"
import "sampledata"

sampledata.float()
    |> promql.timestamp()

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

_time*tag_value
2021-01-01T00:00:00Zt1-2.18
2021-01-01T00:00:10Zt110.92
2021-01-01T00:00:20Zt17.35
2021-01-01T00:00:30Zt117.53
2021-01-01T00:00:40Zt115.23
2021-01-01T00:00:50Zt14.43
_time*tag_value
2021-01-01T00:00:00Zt219.85
2021-01-01T00:00:10Zt24.97
2021-01-01T00:00:20Zt2-3.75
2021-01-01T00:00:30Zt219.77
2021-01-01T00:00:40Zt213.86
2021-01-01T00:00:50Zt21.86

Output data

_time*tag_value
2021-01-01T00:00:00Zt11609459200
2021-01-01T00:00:10Zt11609459210
2021-01-01T00:00:20Zt11609459220
2021-01-01T00:00:30Zt11609459230
2021-01-01T00:00:40Zt11609459240
2021-01-01T00:00:50Zt11609459250
_time*tag_value
2021-01-01T00:00:00Zt21609459200
2021-01-01T00:00:10Zt21609459210
2021-01-01T00:00:20Zt21609459220
2021-01-01T00:00:30Zt21609459230
2021-01-01T00:00:40Zt21609459240
2021-01-01T00:00:50Zt21609459250

{{% /expand %}} {{< /expand-wrapper >}}