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
orhigh_ts
are not a valid signed 64 bit integers, an error is raised. low_ts
andhigh_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"