window_time function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 12.2 LTS and above

Returns the inclusive end time of a time-window produced by the window or session_window functions.

Syntax

window_time(window)

Arguments

  • window: A window column generated by the window function.

Returns

A TIMESTAMP value with the inclusive endpoint of the window. This is equivalent to window.end - INTERVAL '0.000001' SECOND

Examples

> SELECT a, window.start as start, window.end as end, window_time(window), cnt
    FROM (SELECT a, window, count(*) as cnt
           FROM VALUES ('A1', '2021-01-01 00:00:00'),
                       ('A1', '2021-01-01 00:04:30'),
                       ('A1', '2021-01-01 00:06:00'),
                       ('A2', '2021-01-01 00:01:00') AS tab(a, b)
           GROUP by a, window(b, '5 MINUTES'))
    ORDER BY a, window.start;
  A1  2021-01-01 00:00:00  2021-01-01 00:05:00  2021-01-01 00:04:59.999999 2
  A1  2021-01-01 00:05:00  2021-01-01 00:10:00  2021-01-01 00:09:59.999999 1
  A2  2021-01-01 00:00:00  2021-01-01 00:05:00  2021-01-01 00:04:59.999999 1