org.apache.calcite.util

Class TimeString

java.lang.Object

org.apache.calcite.util.TimeString

All Implemented Interfaces:

Comparable<TimeString>

public class TimeString
extends Object
implements Comparable<TimeString>

Time literal.

Immutable, internally represented as a string (in ISO format), and can support unlimited precision (milliseconds, nanoseconds).

Constructor Summary

Constructors

Constructor and Description
TimeString(int h, int m, int s) Creates a TimeString for hour, minute, second and millisecond values.
TimeString(String v) Creates a TimeString.

Method Summary

Modifier and Type	Method and Description
int	compareTo(TimeString o)
boolean	equals(@Nullable Object o)
static TimeString	fromCalendarFields(Calendar calendar) Creates a TimeString from a Calendar.
static TimeString	fromMillisOfDay(int i)
int	getMillisOfDay()
int	hashCode()
TimeString	round(int precision)
Calendar	toCalendar()
String	toString()
String	toString(int precision) Converts this TimestampString to a string, truncated or padded with zeros to a given precision.
TimeString	withFraction(String fraction) Sets the fraction field of a TimeString.
TimeString	withMillis(int millis) Sets the fraction field of a TimeString to a given number of milliseconds.
TimeString	withNanos(int nanos) Sets the fraction field of a TimeString to a given number of nanoseconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeString

public TimeString(String v)

Creates a TimeString.

TimeString

public TimeString(int h,
                  int m,
                  int s)

Creates a TimeString for hour, minute, second and millisecond values.

Method Detail

withMillis

public TimeString withMillis(int millis)

Sets the fraction field of a TimeString to a given number of milliseconds. Nukes the value set via withNanos(int).

For example, new TimeString(1970, 1, 1, 2, 3, 4).withMillis(56) yields TIME '1970-01-01 02:03:04.056'.

withNanos

public TimeString withNanos(int nanos)

Sets the fraction field of a TimeString to a given number of nanoseconds. Nukes the value set via withMillis(int).

For example, new TimeString(1970, 1, 1, 2, 3, 4).withNanos(56789) yields TIME '1970-01-01 02:03:04.000056789'.

withFraction

public TimeString withFraction(String fraction)

Sets the fraction field of a TimeString. The precision is determined by the number of leading zeros. Trailing zeros are stripped.

For example, new TimeString(1970, 1, 1, 2, 3, 4).withFraction("00506000") yields TIME '1970-01-01 02:03:04.00506'.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(@Nullable Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(TimeString o)

Specified by:

compareTo in interface Comparable<TimeString>

fromCalendarFields

public static TimeString fromCalendarFields(Calendar calendar)

Creates a TimeString from a Calendar.

fromMillisOfDay

public static TimeString fromMillisOfDay(int i)

round

public TimeString round(int precision)

getMillisOfDay

public int getMillisOfDay()

toCalendar

public Calendar toCalendar()

toString

public String toString(int precision)

Converts this TimestampString to a string, truncated or padded with zeros to a given precision.