TSREVRANGEBYTIME

Synopsis

TSREVRANGEBYTIME key low_ts high_ts [LIMIT limit]

This command fetches the values for the given low_ts, high_ts range in the time series that is specified by the given key ordered from newest to oldest. If LIMIT is specified, then at most limit pairs will be fetched.

  • 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.
  • If limit is not a valid positive 32 bit integer, 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. If LIMIT is specified, at most limit pairs will be fetched.

Examples

You can do this as shown below.

TSADD ts_key 1 one 2 two 3 three 4 four 5 five 6 six
"OK"
TSREVRANGEBYTIME ts_key 2 4
1) "4"
2) "four"
3) "3"
4) "three"
5) "2"
6) "two"

2 is exclusive

TSREVRANGEBYTIME ts_key (2 4
1) "4"
2) "four"
3) "3"
4) "three"

2 and 4 are exclusive

TSREVRANGEBYTIME ts_key (2 (4
1) "3"
2) "three"
TSREVRANGEBYTIME ts_key -inf 3
1) "3"
2) "three"
3) "2"
4) "two"
5) "1"
6) "one"
TSREVRANGEBYTIME ts_key 2 +inf
 1) "6"
 2) "six"
 3) "5"
 4) "five"
 5) "4"
 6) "four"
 7) "3"
 8) "three"
 9) "2"
10) "two"
TSREVRANGEBYTIME ts_key -inf 3 LIMIT 2
1) "3"
2) "three"
3) "2"
4) "two"
TSREVRANGEBYTIME ts_key -inf 3 LIMIT 10
1) "3"
2) "three"
3) "2"
4) "two"
5) "1"
6) "one"

See also

tsrangebytime, tsadd, tsget, tsrem, tslastn, tscard