Date Range Aggregation · Elasticsearch 5.4 中文文檔

# Date Range Aggregation 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-daterange-aggregation.html#time-zones](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-daterange-aggregation.html#time-zones) 譯文鏈接 :[Date Range Aggregation](/display/Elasticsearch/Date+Range+Aggregation) 貢獻者 : @于永超，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) ## Date Range Aggregation (日期范圍聚合）用于日期值的范圍聚合。此聚合和正常[range](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-range-aggregation.html)(范圍)聚合的主要區別在于可以用[Date Math](https://www.elastic.co/guide/en/elasticsearch/reference/current/common-options.html#date-math)（日期數學）表達式來表示from和to的值，并且還可以指定返回 from 和 to 響應字段的日期格式。注意，此聚合包含 from 值，但是不包含 ?to 值。例子： ``` POST /sales/_search?size=0 { "aggs": { "range": { "date_range": { "field": "date", "format": "MM-yyy", "ranges": [ { "to": "now-10M/M" }, ＃1 { "from": "now-10M/M" } ＃2 ] } } } } ``` ＃1 ? <現在減去10個月，向下舍入到月初＃2 ??>=現在減去10個月，向下舍入到月初上面的例子，我們創建了兩個范圍buckets(區間)，第一個將“bucket”的所有文件在10個月前，而第二個將“bucket”所有的文件都是10個月前的結果： ``` { ... "aggregations": { "range": { "buckets": [ { "to": 1.4436576E12, "to_as_string": "10-2015", "doc_count": 7, "key": "*-10-2015" }, { "from": 1.4436576E12, "from_as_string": "10-2015", "doc_count": 0, "key": "10-2015-*" } ] } } } ``` ### Date Format/Pattern （日期格式）這些信息是從[JodaDate](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html)復制過來的所有ASCII字母都保留為格式模式字母，定義如下: | 符號 | 含義 | Presentation | 范例 | | G | era | text | AD | | C | century of era (>=0) | number | 20 | | Y | year of era (>=0) | year | 1996 | | x | weekyear | year | 1996 | | w | week of weekyear | number | 27 | | e | day of week | number | 2 | | E | day of week | text | Tuesday; Tue | | y | year | year | 1996 | | D | day of year | number | 189 | | M | month of year | month | July; Jul; 07 | | d | day of month | number | 10 | | a | halfday of day | text | PM | | K | hour of halfday (0~11) | number | 0 | | h | clockhour of halfday (1~12) | number | 12 | | H | hour of day (0~23) | number | 0 | | k | clockhour of day (1~24) | number | 24 | | m | minute of hour | number | 30 | | s | second of minute | number | 55 | | S | fraction of second | number | 978 | | z | time zone | text | Pacific Standard Time; PST | | Z | time zone offset/id | zone | -0800; -08:00; America/Los_Angeles | | ' | escape for text | delimiter | '' | 模式字母的數量決定了格式 Text ? ? ?如果模式字母的數量是4或更多，則使用完整的形式，否則，如果有的話，使用簡短或縮寫形式。 Number ? ? 最小位數，如果不足用0填充 Year ? ??特別處理年，年的數字表示。例如，如果y的計數為2，則該年份將顯示為本世紀的零年，這是兩位數。 Month ? ??3或以上，使用文字，否則使用數字 Zone ? ??Z輸出無冒號的偏移量，ZZ以冒號輸出偏移量，ZZZ或更大輸出區域ID。 Zone names ? ??時區名稱（z）無法解析。任何不在[a..z]和[A..Z]范圍內的字符都將被視為引用的文本。例如，像：，。，'，'＃和？即使它們不包含在單引號內，也會出現在生成的時間文本中。 ### Time zone in date range aggregations（日期范圍聚合中的時區）可以通過指定time_zone參數將日期從另一個時區轉換為UTC。時區可以被指定為ISO 8601 UTC偏移量（例如+01：00或-08：00），也可以指定為TZ數據庫的時區ID之一。 time_zone參數也適用于日期數學表達式中的舍入。例如，要在CET時區開始一天的開始，您可以執行以下操作： ``` POST /sales/_search?size=0 { "aggs": { "range": { "date_range": { "field": "date", "time_zone": "CET", "ranges": [ { "to": "2016/02/01" }, ＃1 { "from": "2016/02/01", "to" : "now/d" ＃2}, { "from": "now/d" } ] } } } } ``` ＃1 ??這個日期將改為2016-02-15t00:00 + 01:00 ＃2 ?now/d ?將在CET時區四舍五入到一天的開始 ### Keyed Response 將 keyed 標志設置為 true ，會將唯一的key與每個bucket關聯起來，并將范圍作為散列而不是數組返回 ``` POST /sales/_search?size=0 { "aggs": { "range": { "date_range": { "field": "date", "format": "MM-yyy", "ranges": [ { "to": "now-10M/M" }, { "from": "now-10M/M" } ], "keyed": true } } } } ``` 結果： ``` { ... "aggregations": { "range": { "buckets": { "*-10-2015": { "to": 1.4436576E12, "to_as_string": "10-2015", "doc_count": 7 }, "10-2015-*": { "from": 1.4436576E12, "from_as_string": "10-2015", "doc_count": 0 } } } } } ``` 也可以為每個區間自定義key ``` POST /sales/_search?size=0 { "aggs": { "range": { "date_range": { "field": "date", "format": "MM-yyy", "ranges": [ { "from": "01-2015", "to": "03-2015", "key": "quarter_01" }, { "from": "03-2015", "to": "06-2015", "key": "quarter_02" } ], "keyed": true } } } } ``` 響應結果： ``` { ... "aggregations": { "range": { "buckets": { "quarter_01": { "from": 1.4200704E12, "from_as_string": "01-2015", "to": 1.425168E12, "to_as_string": "03-2015", "doc_count": 5 }, "quarter_02": { "from": 1.425168E12, "from_as_string": "03-2015", "to": 1.4331168E12, "to_as_string": "06-2015", "doc_count": 2 } } } } } ```