Package org.elasticsearch.search.aggregations.bucket.histogram

Class DateHistogramInterval

java.lang.Object

org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval

All Implemented Interfaces:

Writeable, org.elasticsearch.common.xcontent.ToXContent, org.elasticsearch.common.xcontent.ToXContentFragment

public class DateHistogramInterval
extends Object
implements Writeable, org.elasticsearch.common.xcontent.ToXContentFragment

The interval the date histogram is based on.

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

org.elasticsearch.common.xcontent.ToXContent.DelegatingMapParams, org.elasticsearch.common.xcontent.ToXContent.MapParams, org.elasticsearch.common.xcontent.ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static DateHistogramInterval	DAY
static DateHistogramInterval	HOUR
static DateHistogramInterval	MINUTE
static DateHistogramInterval	MONTH
static DateHistogramInterval	QUARTER
static DateHistogramInterval	SECOND
static DateHistogramInterval	WEEK
static DateHistogramInterval	YEAR

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
DateHistogramInterval(String expression)
DateHistogramInterval(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
static DateHistogramInterval	days(int days)
boolean	equals(Object obj)
long	estimateMillis()	Converts this DateHistogramInterval into a millisecond representation.
int	hashCode()
static DateHistogramInterval	hours(int hours)
static DateHistogramInterval	minutes(int min)
static DateHistogramInterval	seconds(int sec)
String	toString()
org.elasticsearch.common.xcontent.XContentBuilder	toXContent(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params)
static DateHistogramInterval	weeks(int weeks)
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContentFragment

isFragment

Field Details

SECOND

public static final DateHistogramInterval SECOND

MINUTE

public static final DateHistogramInterval MINUTE

HOUR

public static final DateHistogramInterval HOUR

DAY

public static final DateHistogramInterval DAY

WEEK

public static final DateHistogramInterval WEEK

MONTH

public static final DateHistogramInterval MONTH

QUARTER

public static final DateHistogramInterval QUARTER

YEAR

public static final DateHistogramInterval YEAR

Constructor Details

DateHistogramInterval

public DateHistogramInterval(String expression)

DateHistogramInterval

public DateHistogramInterval(StreamInput in)
                      throws IOException

Read from a stream.

Throws:

IOException

Method Details

seconds

public static DateHistogramInterval seconds(int sec)

minutes

public static DateHistogramInterval minutes(int min)

hours

public static DateHistogramInterval hours(int hours)

days

public static DateHistogramInterval days(int days)

weeks

public static DateHistogramInterval weeks(int weeks)

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toXContent

public org.elasticsearch.common.xcontent.XContentBuilder toXContent(org.elasticsearch.common.xcontent.XContentBuilder builder,
 org.elasticsearch.common.xcontent.ToXContent.Params params)
                                                             throws IOException

Specified by:

toXContent in interface org.elasticsearch.common.xcontent.ToXContent

Throws:

IOException

estimateMillis

public long estimateMillis()

Converts this DateHistogramInterval into a millisecond representation. If this is a calendar interval, it is an approximation of milliseconds based on the fixed equivalent (e.g. `1h` is treated as 60 fixed minutes, rather than the hour at a specific point in time. This is merely a convenience helper for quick comparisons and should not be used for situations that require precise durations.