Class DateTools

Provides support for converting dates to strings and vice-versa. The strings are structured so that lexicographic sorting orders them by date, which makes them suitable for use as field values and search terms.

This class also helps you to limit the resolution of your dates. Do not save dates with a finer resolution than you really need, as then RangeQuery and PrefixQuery will require more memory and become slower.

Compared to DateField the strings generated by the methods in this class take slightly more space, unless your selected resolution is set to Resolution.DAY or lower.

Another approach is Lucene.Net.Util.NumericUtils, which provides a sortable binary representation (prefix encoded) of numeric values, which date/time are. For indexing a , convert it to unix timestamp as long and index this as a numeric value with NumericField and use NumericRangeQuery<T> to query it.

Inheritance

System.Object

DateTools

Namespace:

Assembly: Lucene.Net.NetCore.dll

Syntax

public class DateTools : object

Methods

Name	Description
DateToString(DateTime, DateTools.Resolution)	Converts a Date to a string suitable for indexing.
Round(DateTime, DateTools.Resolution)	Limit a date's resolution. For example, the date `2004-09-21 13:50:11` will be changed to `2004-09-01 00:00:00` when using `Resolution.MONTH`.
Round(Int64, DateTools.Resolution)	Limit a date's resolution. For example, the date `1095767411000` (which represents 2004-09-21 13:50:11) will be changed to `1093989600000` (2004-09-01 00:00:00) when using `Resolution.MONTH`.
StringToDate(String)	Converts a string produced by `timeToString` or `DateToString` back to a time, represented as a Date object.
StringToTime(String)	Converts a string produced by `timeToString` or `DateToString` back to a time, represented as the number of milliseconds since January 1, 1970, 00:00:00 GMT.
TimeToString(Int64, DateTools.Resolution)	Converts a millisecond time to a string suitable for indexing.