TSRANGEBYTIME

Synopsis

TSRANGEBYTIME key low_ts high_ts
This command fetches the values for the given low_ts, high_ts range in the time series that is specified by the given key.

  • If the given `key` is associated with non-timeseries data, an error is raised.
  • If the given `low_ts` or `high_ts` are not a valid signed 64 bit integers, an error is raised.
  • `low_ts` and `high_ts` are inclusive unless they are prefixed with `(`, in that case they are exclusive.
  • Special bounds `-inf` and `+inf` are also supported to retrieve an entire range

    • Return value

    Returns a list of timestamp, value pairs found in the range specified by low_ts, high_ts.

    Examples

    You can do this as shown below.

    TSADD ts 1 one 2 two 3 three 4 four 5 five 6 six

    "OK"

    TSRANGEBYTIME ts_key 2 4

    1) "2"
2) "two"
3) "3"
4) "three"
5) "4"
6) "four"

    2 is exclusive

    TSRANGEBYTIME ts_key (2 4

    1) "3"
2) "three"
3) "4"
4) "four"

    2 and 4 are exclusive

    TSRANGEBYTIME ts_key (2 (4

    1) "3"
2) "three"

    TSRANGEBYTIME ts_key -inf 3

    1) "1"
2) "one"
3) "2"
4) "two"
5) "3"
6) "three"

    TSRANGEBYTIME ts_key 2 +inf

     1) "2"
 2) "two"
 3) "3"
 4) "three"
 5) "4"
 6) "four"
 7) "5"
 8) "five"
 9) "6"
10) "six"

    See also

    tsrevrangebytime, tsadd, tsget, tsrem, tslastn, tscard