You can filter your search results by date. This is useful if you want to find all the documents that were created or modified in a specific time period.

Setup a date field

To filter by date, you need to add a date field to your index. You can do this by adding a date field to your schema.

Indexing the following document into Elasticsearch will create a date field called date:

 {
   "date": "2015-01-01"
 }

and your mapping will look like this:

{
  "properties": {
    "date": {
      "type": "date"
    }
  }
}

Filter Attribute Configuration

Add a filter attribute to your index configuration. The filter attribute will be used to filter your search results by date.

 {
  "filter_attributes": [
    { attribute: 'date', field: 'date', type: 'date' },
  ]
 }

Using Filter Attributes

You can use the filter attribute in your search query to filter your search results by date within configure.

Syntax Examples

 "date:2015-01-01" # date is 2015-01-01
 "date:[2015-01-01 TO 2015-12-31]" # date is between 2015-01-01 and 2015-12-31
 "date:[2015-01-01 TO *]" # date is greater than 2015-01-01
 "date:[* TO 2015-12-31]" # date is less than 2015-12-31

Example