Skip to content

Add doc section about range query for range type #35222

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 6, 2018
Merged

Add doc section about range query for range type #35222

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
781c8c0
Update range-query.asciidoc
gskema Nov 2, 2018
b399570
Update wording in range query documentation
gskema Nov 5, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions docs/reference/query-dsl/range-query.asciidoc
View file
Open in desktop
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.