Elasticsearch日期范围搜索：如何排除非占位符无关日期？

方法1：使用脚本查询动态筛选年初日期 #

直接在查询中通过脚本判断日期是否为当年1月1日，结合年份范围条件，同时保留精确匹配逻辑：

{
  "query": {
    "bool": {
      "should": [
        // 精确匹配目标日期
        {
          "match": {
            "date": "1992-07-02"
          }
        },
        // 匹配年份在目标日期±2年范围内，且为当年1月1日的文档
        {
          "bool": {
            "must": [
              {
                "range": {
                  "date": {
                    "gte": "1992||-2y/y",
                    "lte": "1992||+2y/y",
                    "format": "yyyy"
                  }
                }
              },
              {
                "script": {
                  "script": {
                    "source": "doc['date'].value.getDayOfMonth() == 1 && doc['date'].value.getMonthValue() == 1"
                  }
                }
              }
            ]
          }
        }
      ],
      "minimum_should_match": 1
    }
  }
}

注意事项 #

脚本查询会对每个命中年份范围的文档执行逻辑判断，数据量较大时可能影响查询性能。

方法2：预新增字段优化性能（推荐大数据量场景） #

如果数据量较大，建议在索引阶段新增布尔字段标记日期是否为当年年初，避免查询时的脚本计算：

1. 更新索引映射 #

新增is_year_start字段，用于标记日期是否为当年1月1日：

{
  "mappings": {
    "properties": {
      "date": {
        "type": "date"
      },
      "is_year_start": {
        "type": "boolean"
      }
    }
  }
}

2. 索引文档时计算字段值 #

写入文档时，判断date是否为yyyy-01-01，若是则将is_year_start设为true，否则为false。

3. 查询语句 #

利用预存字段快速筛选，性能更优：

{
  "query": {
    "bool": {
      "should": [
        // 精确匹配目标日期
        {
          "match": {
            "date": "1992-07-02"
          }
        },
        // 匹配年份范围+年初标记
        {
          "bool": {
            "must": [
              {
                "range": {
                  "date": {
                    "gte": "1992||-2y/y",
                    "lte": "1992||+2y/y",
                    "format": "yyyy"
                  }
                }
              },
              {
                "term": {
                  "is_year_start": true
                }
              }
            ]
          }
        }
      ],
      "minimum_should_match": 1
    }
  }
}

方法3：手动指定年初日期（适合固定范围场景） #

如果年份范围固定，也可以直接用terms查询列出所有需要匹配的年初日期，无需动态计算：

{
  "query": {
    "bool": {
      "should": [
        {
          "match": {
            "date": "1992-07-02"
          }
        },
        {
          "terms": {
            "date": [
              "1990-01-01",
              "1991-01-01",
              "1992-01-01",
              "1993-01-01",
              "1994-01-01"
            ]
          }
        }
      ],
      "minimum_should_match": 1
    }
  }
}

内容的提问来源于stack exchange，提问作者MrFerixx