query.fromRange() function

The query.fromRange() function is experimental and subject to change at any time. By using this function, you accept the risks of experimental functions.

The query.fromRange() function returns all data from a specified bucket within given time bounds.

*Function type: Input*

  1. import "experimental/query"
  2. query.fromRange(
  3. bucket: "example-bucket",
  4. start: -1h,
  5. stop: now()
  6. )

Parameters

bucket

The name of the bucket to query.

*Data type: String*

start

The earliest time to include in results. Results include points that match the specified start time. Use a relative duration, absolute time, or integer (Unix timestamp in seconds). For example, -1h, 2019-08-28T22:00:00Z, or 1567029600.. Durations are relative to now().

*Data type: Duration | Time | Integer*

stop

The latest time to include in results. Results exclude points that match the specified stop time. Use a relative duration, absolute time, or integer (Unix timestamp in seconds). For example, -1h, 2019-08-28T22:00:00Z, or 1567029600. Durations are relative to now(). Defaults to now().

*Data type: Duration | Time | Integer*

Examples

  1. import "experimental/query"
  2. query.fromRange(
  3. bucket: "example-bucket",
  4. start: 2020-01-01T00:00:00Z
  5. )

Function definition

  1. package query
  2. fromRange = (bucket, start, stop=now()) =>
  3. from(bucket: bucket)
  4. |> range(start: start, stop: stop)

Used functions:
from()
range()