content/flux/v0/stdlib/universe/hourselection.md
hourSelection() filters rows by time values in a specified hour range.
(
<-tables: stream[A],
start: int,
stop: int,
?location: {zone: string, offset: duration},
?timeColumn: string,
) => stream[A] where A: Record
{{% caption %}} For more information, see Function type signatures. {{% /caption %}}
({{< req >}})
First hour of the hour range (inclusive). Hours range from [0-23].
({{< req >}})
Last hour of the hour range (inclusive). Hours range from [0-23].
Location used to determine timezone. Default is the location option.
Column that contains the time value. Default is _time.
Input data. Default is piped-forward data (<-).
data
|> hourSelection(start: 9, stop: 17)
{{< expand-wrapper >}} {{% expand "View example input and output" %}}
| _time | tag | _value |
|---|---|---|
| 2022-01-01T05:00:00Z | t1 | -2 |
| 2022-01-01T09:00:10Z | t1 | 10 |
| 2022-01-01T11:00:20Z | t1 | 7 |
| 2022-01-01T16:00:30Z | t1 | 17 |
| 2022-01-01T19:00:40Z | t1 | 15 |
| 2022-01-01T20:00:50Z | t1 | 4 |
| _time | tag | _value |
|---|---|---|
| 2022-01-01T09:00:10Z | t1 | 10 |
| 2022-01-01T11:00:20Z | t1 | 7 |
| 2022-01-01T16:00:30Z | t1 | 17 |
{{% /expand %}} {{< /expand-wrapper >}}