Module org.elasticsearch.server

Package org.elasticsearch.common

Class Rounding

java.lang.Object

org.elasticsearch.common.Rounding

All Implemented Interfaces:

Writeable

public abstract class Rounding
extends Object
implements Writeable

A strategy for rounding milliseconds since epoch.

There are two implementations for rounding. The first one requires a date time unit and rounds to the supplied date time unit (i.e. quarter of year, day of month). The second one allows you to specify an interval to round to.

See this blog for some background reading. Its super interesting and the links are a comedy gold mine. If you like time zones. Or hate them.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Rounding.Builder
static enum	Rounding.DateTimeUnit
static interface	Rounding.Prepared	A strategy for rounding milliseconds since epoch.

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

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

Constructor Summary

Constructors

Constructor	Description
Rounding()

Method Summary

Modifier and Type	Method	Description
static Rounding.Builder	builder(Rounding.DateTimeUnit unit)
static Rounding.Builder	builder(TimeValue interval)
abstract boolean	equals(Object obj)
abstract int	hashCode()
abstract byte	id()
abstract void	innerWriteTo(StreamOutput out)
final long	nextRoundingValue(long utcMillis)	Deprecated. Prefer prepare(long, long) and then Rounding.Prepared.nextRoundingValue(long)
abstract long	offset()	Deprecated. We're in the process of abstracting offset *into* Rounding so keep any usage to migratory shims
abstract Rounding.Prepared	prepare(long minUtcMillis, long maxUtcMillis)	Prepare to round many times.
abstract Rounding.Prepared	prepareForUnknown()	Prepare to round many dates over an unknown range.
abstract Rounding.Prepared	prepareJavaTime()	Prepare rounding forcing the java time implementation.
static Rounding	read(StreamInput in)
final long	round(long utcMillis)	Deprecated. Prefer prepare(long, long) and then Rounding.Prepared.round(long)
abstract Rounding	withoutOffset()	Strip the offset from these bounds.
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class java.lang.Object

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

Constructor Details

Rounding

public Rounding()

Method Details

innerWriteTo

public abstract void innerWriteTo(StreamOutput out)
                           throws IOException

Throws:

IOException

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

id

public abstract byte id()

prepare

public abstract Rounding.Prepared prepare(long minUtcMillis,
 long maxUtcMillis)

Prepare to round many times.

prepareForUnknown

public abstract Rounding.Prepared prepareForUnknown()

Prepare to round many dates over an unknown range. Prefer prepare(long, long) if you can find the range because it'll be much more efficient.

prepareJavaTime

public abstract Rounding.Prepared prepareJavaTime()

Prepare rounding forcing the java time implementation. Prefer prepare(long, long) or prepareForUnknown() which can be much faster.

round

@Deprecated
public final long round(long utcMillis)

Deprecated.

Prefer prepare(long, long) and then Rounding.Prepared.round(long)

Rounds the given value.

nextRoundingValue

@Deprecated
public final long nextRoundingValue(long utcMillis)

Deprecated.

Prefer prepare(long, long) and then Rounding.Prepared.nextRoundingValue(long)

Given the rounded value (which was potentially generated by round(long), returns the next rounding value. For example, with interval based rounding, if the interval is 3, nextRoundValue(6) = 9.

offset

@Deprecated
public abstract long offset()

Deprecated.

We're in the process of abstracting offset *into* Rounding so keep any usage to migratory shims

How "offset" this rounding is from the traditional "start" of the period.

withoutOffset

public abstract Rounding withoutOffset()

Strip the offset from these bounds.

equals

public abstract boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public abstract int hashCode()

Overrides:

hashCode in class Object

builder

public static Rounding.Builder builder(Rounding.DateTimeUnit unit)

builder

public static Rounding.Builder builder(TimeValue interval)

read

public static Rounding read(StreamInput in)
                     throws IOException

Throws:

IOException