Apache Solr Reference Guide Covering Apache Solr 6.0

Working with Dates
Date Formatting
Solr's date fields ( TrieDateField and DateRangeField) represents a point in time with millisecond
precision. The format used is a restricted form of the canonical representation of dateTime in the XML Schema
specification – a restricted subset of ISO-8601. For those familiar with Java 8, Solr uses DateTimeFormatter.IS
O_INSTANT for formatting, and parsing too with "leniency".
YYYY-MM-DDThh:mm:ssZ
YYYY is the year.
MM is the month.
DD is the day of the month.
hh is the hour of the day as on a 24-hour clock.
mm is minutes.
ss is seconds.
Z is a literal 'Z' character indicating that this string representation of the date is in UTC
Note that no time zone can be specified; the String representations of dates is always expressed in Coordinated
Universal Time (UTC). Here is an example value:
1972-05-20T17:33:18Z
You can optionally include fractional seconds if you wish, although any precision beyond milliseconds will be
ignored. Here are example values with sub-seconds:
1972-05-20T17:33:18.772Z
1972-05-20T17:33:18.77Z
1972-05-20T17:33:18.7Z
There must be a leading '-' for dates prior to year 0000, and Solr will format dates with a leading ' + ' for years
after 9999. Year 0000 is considered year 1 BC; there is no such thing as year 0 AD or BC.
Query escaping may be required
As you can see, the date format includes colon characters separating the hours, minutes, and seconds.
Because the colon is a special character to Solr's most common query parsers, escaping is sometimes
required, depending on exactly what you are trying to do.
This is normally an invalid query:
datefield:1972-05-20T17:33:18.772Z
These are valid queries:
datefield:1972-05-20T17\:33\:18.772Z
datefield:"1972-05-20T17:33:18.772Z"
datefield:[1972-05-20T17:33:18.772 TO *]
Date Range Formatting
Solr's DateRangeField supports the same point in time date syntax described above (with date math describe
d below) and more to express date ranges. One class of examples is truncated dates, which represent the entire
date span to the precision indicated. The other class uses the range syntax ([ TO ]). Here are some
examples:
2000-11 – The entire month of November, 2000.
2000-11T13 – Likewise but for the 13th hour of the day (1pm-2pm).
Apache Solr Reference Guide 6.0
57