Date range search

This page describes how you can search by date with date range search. As well it describes the creation of date wise search queries, and also describes the management of formats for date range search.

Creating date range search queries

Date range search allows you to search in documents dates from a given range in given date formats.

Queries for date range search in text form are specified in the following format:

  • daterange( date ~~ date )

where date is the date in yyyy-MM-dd format, for example, 2019-09-13. Please note that in a search query, dates are always set in the same format.

The following example demonstrates how to search by date using queries in text and object form.

const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for dates using query in text form
const query1 = 'daterange(2017-01-01 ~~ 2019-12-31)';

const result1 = index.search(query1);
// Search for dates using query in text form
const query2 = groupdocs.search.SearchQuery.createDateRangeQuery(
  Utils.createDate(2017, 1, 1),
  Utils.createDate(2019, 12, 31),
);
const result2 = index.search(query2);

Specifying date range search formats

To perform the date range search, the date templates specified in the search options are used. The following formats are used by default:

  • dd.MM.yyyy
  • MM/dd/yyyy
  • yyyy-MM-dd

Formats for date range search are set in the collection that is returned by the getDateFormats method of the SearchOptions class. To add a format, use the addItem method, to remove it, use the removeItem method, to clear a collection of existing formats, use the clear method. Each format in the collection is defined by an instance of the DateFormat class. To create a new format, you must specify a sequence of format elements and a separator character. All available format elements are represented in the DateFormatElement class:

  • getDayOfMonth method returns the day of month element, represented by one or two digits;
  • getDayOfMonthTwoDigits method returns the day of month element, represented by two digits;
  • getMonth method returns the month element, represented by one or two digits;
  • getMonthTwoDigits method returns the month element, represented by two digits;
  • getMonthAbbreviatedName method returns the month element, represented by abbreviated name;
  • getMonthFullName method returns the month element, represented by full name;
  • getYear method returns the year element, represented by one, two, three, or four digits;
  • getYearTwoDigits method returns the year element, represented by two digits;
  • getYearFourDigits method returns the year element, represented by four digits;
  • getDateSeparator method returns the date separator element.

An example of setting the date format for the search is presented below.

const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Setting date formats
const options = new groupdocs.search.SearchOptions();
options.getDateFormats().clear(); // Removing default date formats
const elements = java.newArray('com.groupdocs.search.options.DateFormatElement', [
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDayOfMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getYearFourDigits'),
]);
// Creating a date format pattern 'MM/dd/yyyy'
const dateFormat = new groupdocs.search.DateFormat(elements, '/');
options.getDateFormats().addItem(dateFormat);

// Searching in the index.
// For the given query, for example, the date 09/27/2019 will be found,
// but the date 2019-09-27 will not be found, because it is presented in a format that is not specified in the search options.
const query = 'daterange(2017-01-01 ~~ 2019-12-31)';
const result = index.search(query, options);

More resources

GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online Free Online Document Search App.