Skip to content

Commit

Permalink
Docs: Add section about range query for range type (#35222)
Browse files Browse the repository at this point in the history
This makes their interaction more discoverable.
  • Loading branch information
gskema authored and nik9000 committed Nov 6, 2018
1 parent fa0f300 commit 9dc2f1a
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions docs/reference/query-dsl/range-query.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -139,3 +139,26 @@ GET _search
// CONSOLE
<1> This date will be converted to `2014-12-31T23:00:00 UTC`.
<2> `now` is not affected by the `time_zone` parameter (dates must be stored as UTC).

[[querying-range-fields]]
==== Querying range fields

`range` queries can be used on fields of type <<range,`range`>>, allowing to
match a range specified in the query with a range field value in the document.
The `relation` parameter controls how these two ranges are matched:

[horizontal]
`WITHIN`::

Matches documents who's range field is entirely within the query's range.

`CONTAINS`::

Matches documents who's range field entirely contains the query's range.

`INTERSECTS`::

Matches documents who's range field intersects the query's range.
This is the default value when querying range fields.

For examples, see <<range,`range`>> mapping type.

0 comments on commit 9dc2f1a

Please sign in to comment.