first_time()

Since 1.11.0

Get the timestamp of the first point in a TimeWeightSummary aggregate.

Samples

Produce a linear TimeWeightSummary over the column val and get the first timestamp:

WITH t as (
    SELECT
        time_bucket('1 day'::interval, ts) as dt,
        time_weight('Linear', ts, val) AS tw
    FROM table
    GROUP BY time_bucket('1 day'::interval, ts)
)
SELECT
    dt,
    first_time(tw)
FROM t;

Arguments

The syntax is:

first_time(
    tw TimeWeightSummary
) RETURNS TIMESTAMPTZ

Name	Type	Default	Required	Description
tws	TimeWeightSummary	-	✔	The input TimeWeightSummary from a time_weight() call

Returns

Column	Type	Description
first_time	TIMESTAMPTZ	The time of the first point in the TimeWeightSummary