Loading

ES|QL RANGE_CONTAINS function

Returns true if a date range contains a given date or sub-range.

Embedded
left
Container range.
right

Value to test (point or range).

Returns true if the first argument contains the second argument. This is the inverse of RANGE_WITHIN; equivalent to RANGE_WITHIN(b, a). Supports (date_range, date) and (date_range, date_range). The first argument must be a date_range.

left right result
date_range date boolean
date_range date_range boolean
FROM employees
| WHERE RANGE_CONTAINS(TO_DATE_RANGE("1985-02-01..1985-03-01"), hire_date)
| KEEP emp_no, hire_date
| SORT emp_no
		
emp_no:integer hire_date:date
10009 1985-02-18T00:00:00.000Z
10048 1985-02-24T00:00:00.000Z

Filter ranges that contain a target date or sub-range