docs-v2/content/flux/v0/stdlib/internal/promql/timestamp.md

title	description	menu	weight
promql.timestamp() function	`promql.timestamp()` implements functionality equivalent to [PromQL's `timestamp()` function](https://prometheus.io/docs/prometheus/latest/querying/functions/#timestamp).	flux_v0_ref name parent identifier promql.timestamp internal/promql internal/promql/timestamp	201

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

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

Function type signature

(<-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

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:00Z	t1	-2.18
2021-01-01T00:00:10Z	t1	10.92
2021-01-01T00:00:20Z	t1	7.35
2021-01-01T00:00:30Z	t1	17.53
2021-01-01T00:00:40Z	t1	15.23
2021-01-01T00:00:50Z	t1	4.43

_time	*tag	_value
2021-01-01T00:00:00Z	t2	19.85
2021-01-01T00:00:10Z	t2	4.97
2021-01-01T00:00:20Z	t2	-3.75
2021-01-01T00:00:30Z	t2	19.77
2021-01-01T00:00:40Z	t2	13.86
2021-01-01T00:00:50Z	t2	1.86

Output data

_time	*tag	_value
2021-01-01T00:00:00Z	t1	1609459200
2021-01-01T00:00:10Z	t1	1609459210
2021-01-01T00:00:20Z	t1	1609459220
2021-01-01T00:00:30Z	t1	1609459230
2021-01-01T00:00:40Z	t1	1609459240
2021-01-01T00:00:50Z	t1	1609459250

_time	*tag	_value
2021-01-01T00:00:00Z	t2	1609459200
2021-01-01T00:00:10Z	t2	1609459210
2021-01-01T00:00:20Z	t2	1609459220
2021-01-01T00:00:30Z	t2	1609459230
2021-01-01T00:00:40Z	t2	1609459240
2021-01-01T00:00:50Z	t2	1609459250

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