Module org.elasticsearch.server

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

Class DateHistogramInterval

java.lang.Object

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

All Implemented Interfaces:

Writeable, ToXContent, ToXContentFragment

public class DateHistogramInterval
extends Object
implements Writeable, ToXContentFragment

The interval the date histogram is based on.

Nested Class Summary

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

ToXContent.DelegatingMapParams, ToXContent.MapParams, 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 final DateHistogramInterval	DAY
static final DateHistogramInterval	HOUR
static final DateHistogramInterval	MINUTE
static final DateHistogramInterval	MONTH
static final DateHistogramInterval	QUARTER
static final DateHistogramInterval	SECOND
static final DateHistogramInterval	WEEK
static final DateHistogramInterval	YEAR

Fields inherited from interface org.elasticsearch.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()
XContentBuilder	toXContent(XContentBuilder builder, 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.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 XContentBuilder toXContent(XContentBuilder builder,
 ToXContent.Params params)
                           throws IOException

Specified by:

toXContent in interface 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.