Range Query · my-elasticsearch-cn

# Range Query(范圍查詢) 通過某一個包含項的字段匹配文檔。?**Lucene**?查詢的類型取決于字段類型，對于*string*?（字符串字段），查詢是一個?**TermRangeQuery**?，而對于?*number / date*?字段，查詢是一個?**NumericRangeQuery?**。下面這個示例返回?*age*?在?*10*?到?*20*?之間的所有文檔。范圍查詢接受以下參數： | 參數 | 說明 | | --- | --- | | gte | 大于或等于 | | gt | 大于 | | lte | 小于或等于 | | lt | 小于 | | boost | 設置查詢的?*boost*?值，默認為?*1.0* | ## ?date （日期）字段的范圍查詢對類型為?[**date**?](https://www.elastic.co/guide/en/elasticsearch/reference/current/date.html)（日期）的字段運行?**range**?（范圍）查詢時，可以使用?*“[Date Math](https://www.elastic.co/guide/en/elasticsearch/reference/current/common-options.html#date-math)”*部分指定范圍： | `GET _search` `{` `"query"``: {` `"range"`?`: {` `"date"`?`: {` `"gte"`?`:?``"now-1d/d"``,` `"lt"`?`:??``"now/d"` `}` `}` `}` `}` | ### ?Date math 和 rounding （四舍五入）當使用?**[date math](https://www.elastic.co/guide/en/elasticsearch/reference/current/common-options.html#date-math)**?將日期?*round*?（四舍五入）到最近的日，月，小時等時，舍入日期取決于范圍的結束是包含還是排除。向上舍入移動到舍入范圍的最后一個毫秒，并向下舍入到舍入范圍的第一個毫秒。例如： | 參數 | 說明 | | --- | --- | | gt | 大于向上舍入的日期：?*2014-11-18 || / M*?變成?*2014-11-30T23：59：59.999*?，即不包括整個月。 | | gte | 大于或等于向下舍入的日期：?*2014-11-18 || / M*?即成為?*2014-11-01*，即包括整個月。 | | lt | 小于向下舍入的日期：?*2014-11-18 || / M?*成為?*2014-11-01?*，即不包括整個月。 | | lte | 小于或等于向上舍入的日期：?*2014-11-18 || / M?*成為?*2014-11-30T23：59：59.999?*，即包括整個月。 | ### ?Range （范圍）查詢中的日期格式化格式化的日期將使用指定的默認?**[format](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-date-format.html)**?（格式）解析?[**date**?](https://www.elastic.co/guide/en/elasticsearch/reference/current/date.html)（日期）字段，但可以通過將格式參數傳遞到?**range**?（范圍）查詢來覆蓋默認格式： | `GET _search` `{` `"query"``: {` `"range"`?`: {` `"born"`?`: {` `"gte"``:?``"01/01/2012"``,` `"lte"``:?``"2013"``,` `"format"``:?``"dd/MM/yyyy||yyyy"` `}` `}` `}` `}` | ### ?Range （范圍）查詢中的時區通過在日期值本身指定時區（如果?**[format](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-date-format.html)**?允許），日期可以從另一個時區轉換為**UTC**?，或者可以將其指定為?*time_zone*?參數： | `GET _search` `{` `"query"``: {` `"range"`?`: {` `"timestamp"`?`: {` `"gte"``:?``"2015-01-01 00:00:00"``, ①` `"lte"``:?``"now"``, ②` `"time_zone"``:?``"+01:00"` `}` `}` `}` `}` | ①此日期將轉換為*?2014-12-31T23：00：00 UTC*?。 ②?*now*?不受?*time_zone*?參數的影響（日期必須存儲為UTC）。