1 範圍查詢的符號

符號	含義
gte	greater-than or equal to, 大於或等於
gt	greater-than, 大於
lte	less-than or equal to, 小於或等於
lt	less-than, 小於

2 數值範圍查詢

需求: 查詢商品中40 <= price <= 80的文檔:html

GET book_shop/_search
{
    "query": {
        "range": {
            "price": {
                "gte": 40,
                "lte": 80,
                "boost": 2.0	// 設置得分的權重值(提高值), 默認是1.0
            }
        }
    }
}

3 時間範圍查詢

3.1 簡單查詢示例

需求: 查詢網站中最近一天發佈的博客:web

GET website/_search
{
    "query": {
        "range": {
            "post_date": {
            	"gte": "now-1d/d",	// 當前時間的上一天, 四捨五入到最近的一天
            	"lt":  "now/d"		// 當前時間, 四捨五入到最近的一天
        	}
        }
    }
}

3.2 關於時間的數學表達式(date-math)

Elasticsearch中時間能夠表示爲now, 也就是系統當前時間, 也能夠是以||結尾的日期字符串表示.json

在日期以後, 能夠選擇一個或多個數學表達式:less

+1h —— 加1小時;
-1d —— 減1天;
/d —— 四捨五入到最近的一天.

下面是Elasticsearch支持數學表達式的時間單位:elasticsearch

表達式	含義	表達式	含義
`y`	年	`M`	月
`w`	星期	`d`	天
`h`	小時	`H`	小時
`m`	分鐘	`s`	秒

說明: 假設系統當前時間now = 2018-10-01 12:00:00 :ide

now+1h: now的毫秒值 + 1小時, 結果是: 2018-10-01 13:00:00.
now-1h: now的毫秒值 - 1小時, 結果是: 2018-10-01 11:00:00.
now-1h/d: now的毫秒值 - 1小時, 而後四捨五入到最近的一天的起始, 結果是: 2018-10-01 00:00:00.
2018.10.01||+1M/d: 2018-10-01的毫秒值 + 1月, 再四捨五入到最近一天的起始, 結果是: 2018-11-01 00:00:00.

3.3 關於時間的四捨五入

對日期中的日、月、小時等進行四捨五入時, 取決於範圍的結尾是包含(include)仍是排除(exclude).post

向上舍入: 移動到舍入範圍的最後一毫秒;網站

向下舍入: 必定到舍入範圍的第一毫秒.ui

舉例說明:spa

① "gt": "2018-12-18||/M" —— 大於日期, 須要向上舍入, 結果是2018-12-31T23:59:59.999, 也就是不包含整個12月.

② "gte": "2018-12-18||/M" —— 大於或等於日期, 須要向下舍入, 結果是 2018-12-01, 也就是包含整個12月.

③ "lt": "2018-12-18||/M" —— 小於日期, 須要向上舍入, 結果是2018-12-01, 也就是不包含整個12月.

④ "lte": "2018-12-18||/M" —— 小於或等於日期, 須要向下舍入, 結果是2018-12-31T23:59:59.999, 也就是包含整個12月.

4 日期格式化範圍查詢(format)

格式化日期查詢時, 將默認使用日期field中指定的格式進行解析, 固然也能夠經過format參數來覆蓋默認配置.

示例:

GET website/_search
{
    "query": {
        "range": {
            "post_date": {
                "gte": "2/1/2018", 
                "lte": "2019",
                "format": "dd/MM/yyyy||yyyy"
            }
        }
    }
}

注意: 若是日期中缺失了部分年、月、日, 缺失的部分將被填充爲unix系統的初始值, 也就是1970年1月1日.

好比, 將dd指定爲format, 像"gte": 10將轉換爲1970-01-10T00:00:00.000Z.

5 時區範圍查詢(time_zone)

若是日期field的格式容許, 也能夠經過在日期值自己中指定時區, 從而將日期從另外一個時區的時間轉換爲UTC時間, 或者爲其指定特定的time_zone參數.

示例:

GET website/_search
{
    "query": {
        "range": {
            "post_date": {
                "gte": "2018-01-01 00:00:00",
                "lte": "now",
                "format": "yyyy-MM-dd hh:mm:ss",
                "time_zone": "+1:00"
            }
        }
    }
}

ES中的日期類型必須按照UTC時間格式存儲, 因此, 上述的2018-01-01 00:00:00將被轉換爲2017-12-31T23:00:00 UTC.

另外須要注意的是, now是不受time_zone影響的.

參考資料

Elasticsearch官方文檔 - Range Query

版權聲明

做者: 馬瘦風(https://healchow.com)

出處: 博客園馬瘦風的博客(https://www.cnblogs.com/shoufeng)

感謝閱讀, 若是文章有幫助或啓發到你, 點個[好文要頂👆] 或 [推薦👍] 吧😜

本文版權歸博主全部, 歡迎轉載, 但 [必須在文章頁面明顯位置標明原文連接], 不然博主保留追究相關人員法律責任的權利.

ES 22 - Elasticsearch中如何進行日期(數值)範圍查詢