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-time series 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