- java.lang.Object
-
- com.pervasive.datarush.sequences.scalar.AbstractScalarTokenSequence
-
- com.pervasive.datarush.sequences.scalar.TimestampTokenList
-
- All Implemented Interfaces:
MutableTokenSequence
,MutableScalarTokenSequence
,MutableTimestampTokenSequence
,ScalarTokenAppendable
,ScalarTokenSequence
,TimestampTokenSequence
,TokenAppendable
,TokenSequence
,ScalarTyped
,TokenTyped
public final class TimestampTokenList extends AbstractScalarTokenSequence implements MutableTimestampTokenSequence
Primary implementation ofMutableTimestampTokenSequence
.- See Also:
TokenTypeConstant.TIMESTAMP
-
-
Constructor Summary
Constructors Constructor Description TimestampTokenList(int capacity)
Create a new array of timestamp tokens with the specified number of elements.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
append(Timestamp value)
Appends the specified timestamp to this sequence.void
append(Timestamp value, int count)
Appends the specified timestamp to this sequence multiple times.void
appendEpochTime(long epochSeconds, int subsecondNanos, int offsetSeconds)
Appends the timestamp specified in epoch time to this sequence.void
appendEpochTime(long epochSeconds, int subsecondNanos, int offsetSeconds, int count)
Appends the timestamp specified in epoch time to this sequence multiple times.void
fillEpochSeconds(int start, int length, long seconds, int nanos, int offsetSeconds)
Sets the tokens in the specified subsequence to a timestamp value specified as time since Java epoch (January 1, 1970 00:00:00 GMT) with time zone and daylight saving time offset.void
fillTimestamp(int start, int length, Timestamp value)
Sets the tokens in the specified subsequence to a timestamp value specified as ajava.sql.Timestamp
object, relative to the default time zone.void
fillTimestamp(int start, int length, Timestamp value, TimeZone tz)
Sets the tokens in the specified subsequence to a timestamp value specified as ajava.sql.Timestamp
object, relative to the given time zone.void
fillValue(int start, int length, TokenValued value)
Sets the tokens in the specified subsequence to the given value.long
getEpochSeconds(int i)
Gets the value of the specified token as the number of seconds elapsed since January 1, 1970 00:00:00 GMT.int
getOffsetSeconds(int i)
Gets the time zone plus daylight savings time offset (in seconds) of the timestamp value of the specified token.int
getSubsecondNanos(int i)
Gets the subsecond portion (in nanoseconds) of the timestamp value of the specified token.Timestamp
getTimestamp(int i)
Gets the value of the specified token as a timestamp.TimestampValued
getToken(int index)
Gets the value at the specified position.TimestampSettable
getTokenSetter(int index)
Returns a mutator for the given index.ScalarTokenType
getType()
Gets the data type of the tokens in the sequence.void
getValues(int index, long[] secValues, int[] nanoValues, int[] offsetValues, boolean[] nullFlags, int offset, int length)
Gets the values and null indicators for a range of tokens.boolean
isZero(int index)
Indicates whether the specified token has a zero value.TimestampValuedIterator
newValueIterator()
Creates an iterator over the non-null values of this sequence.void
setEpochSeconds(int index, long seconds, int nanos, int offsetSeconds)
Sets the token at the specified position to a timestamp value specified as time since Java epoch (January 1, 1970 00:00:00 GMT) with time zone and daylight saving time offset.void
setNull(int index)
Sets the token at the specified position to be null valued.void
setNull(int start, int length)
Sets the tokens in the specified subsequence to be null valued.void
setTimestamp(int index, Timestamp value)
Sets the token at the specified position to a timestamp value specified as ajava.sql.Timestamp
object, relative to the default time zone.void
setTimestamp(int index, Timestamp value, TimeZone tz)
Sets the token at the specified position to a timestamp value specified as ajava.sql.Timestamp
object, relative to the given time zone.void
setValue(int index, TokenValued value)
Sets the token at the specified position to the given value.void
setValues(int start, TokenSequence values, int offset, int length)
Sets the tokens in the specified subsequence of the array to the corresponding values from a subsequence of the given source sequence.void
setZero(int index)
Sets the token at the specified position to be zero valued.void
setZero(int start, int length)
Sets the tokens in the specified subsequence to be zero valued.-
Methods inherited from class com.pervasive.datarush.sequences.scalar.AbstractScalarTokenSequence
append, append, append, append, appendNull, appendNull, appendZero, appendZero, capacity, compareElement, compareElements, ensureCanonical, getElementComparator, getModificationCount, hashCode, isNull, isNull, map, remaining, reset, size, toString, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.pervasive.datarush.sequences.scalar.MutableScalarTokenSequence
ensureCanonical, getModificationCount
-
Methods inherited from interface com.pervasive.datarush.sequences.MutableTokenSequence
appendNull, appendNull, appendZero, appendZero, reset
-
Methods inherited from interface com.pervasive.datarush.sequences.scalar.ScalarTokenSequence
isNull
-
Methods inherited from interface com.pervasive.datarush.sequences.TokenAppendable
append, append, append, append
-
Methods inherited from interface com.pervasive.datarush.sequences.TokenSequence
compareElement, compareElements, getElementComparator, hashCode, isNull, size, toString
-
-
-
-
Method Detail
-
getType
public ScalarTokenType getType()
Description copied from interface:ScalarTokenSequence
Gets the data type of the tokens in the sequence.- Specified by:
getType
in interfaceScalarTokenSequence
- Specified by:
getType
in interfaceScalarTyped
- Specified by:
getType
in interfaceTokenTyped
- Returns:
- the token data type
-
getTimestamp
public Timestamp getTimestamp(int i)
Description copied from interface:TimestampTokenSequence
Gets the value of the specified token as a timestamp.- Specified by:
getTimestamp
in interfaceTimestampTokenSequence
- Parameters:
i
- the position of the token in the sequence- Returns:
- the value of the token. If the
token is null valued,
null
is returned.
-
getEpochSeconds
public long getEpochSeconds(int i)
Description copied from interface:TimestampTokenSequence
Gets the value of the specified token as the number of seconds elapsed since January 1, 1970 00:00:00 GMT.- Specified by:
getEpochSeconds
in interfaceTimestampTokenSequence
- Parameters:
i
- the position of the token in the sequence- Returns:
- the value of the token. If the
token is null valued,
0
is returned.
-
getSubsecondNanos
public int getSubsecondNanos(int i)
Description copied from interface:TimestampTokenSequence
Gets the subsecond portion (in nanoseconds) of the timestamp value of the specified token.- Specified by:
getSubsecondNanos
in interfaceTimestampTokenSequence
- Parameters:
i
- the position of the token in the sequence- Returns:
- the subsecond portion of the value in nanoseconds.
If the token is null valued,
0
is returned.
-
getOffsetSeconds
public int getOffsetSeconds(int i)
Description copied from interface:TimestampTokenSequence
Gets the time zone plus daylight savings time offset (in seconds) of the timestamp value of the specified token.- Specified by:
getOffsetSeconds
in interfaceTimestampTokenSequence
- Parameters:
i
- the position of the token in the sequence- Returns:
- the time zone plus daylight savings time offset in seconds.
If the token is null valued,
0
is returned.
-
getToken
public TimestampValued getToken(int index)
Description copied from interface:TokenSequence
Gets the value at the specified position.- Specified by:
getToken
in interfaceScalarTokenSequence
- Specified by:
getToken
in interfaceTimestampTokenSequence
- Specified by:
getToken
in interfaceTokenSequence
- Parameters:
index
- the index of the token- Returns:
- the value
-
getTokenSetter
public TimestampSettable getTokenSetter(int index)
Description copied from interface:MutableTokenSequence
Returns a mutator for the given index.- Specified by:
getTokenSetter
in interfaceMutableScalarTokenSequence
- Specified by:
getTokenSetter
in interfaceMutableTimestampTokenSequence
- Specified by:
getTokenSetter
in interfaceMutableTokenSequence
- Parameters:
index
- the position- Returns:
- a mutator for the given index.
-
getValues
public void getValues(int index, long[] secValues, int[] nanoValues, int[] offsetValues, boolean[] nullFlags, int offset, int length)
Description copied from interface:TimestampTokenSequence
Gets the values and null indicators for a range of tokens.- Specified by:
getValues
in interfaceTimestampTokenSequence
- Parameters:
index
- the starting index of the rangesecValues
- an array into which to place the epoch second values of elementsnanoValues
- an array into which to place the subsecond values of elementsoffsetValues
- an array into which to place the offset seconds values of elementsnullFlags
- an array into which to place null indicator valuesoffset
- the starting offset into the target arrays. That is,elements[offset]
andnulls[offset]
will get the value and null indicator respectively of the token at positionstart
, and so on.length
- number of tokens to get
-
setNull
public void setNull(int index)
Description copied from interface:MutableTokenSequence
Sets the token at the specified position to be null valued.- Specified by:
setNull
in interfaceMutableTokenSequence
- Parameters:
index
- the position of the token in the array
-
setNull
public void setNull(int start, int length)
Description copied from interface:MutableTokenSequence
Sets the tokens in the specified subsequence to be null valued.- Specified by:
setNull
in interfaceMutableTokenSequence
- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequence
-
setZero
public void setZero(int index)
Description copied from interface:MutableTokenSequence
Sets the token at the specified position to be zero valued.- Specified by:
setZero
in interfaceMutableTokenSequence
- Parameters:
index
- the position of the token in the array
-
setZero
public void setZero(int start, int length)
Description copied from interface:MutableTokenSequence
Sets the tokens in the specified subsequence to be zero valued.- Specified by:
setZero
in interfaceMutableTokenSequence
- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequence
-
isZero
public boolean isZero(int index)
Description copied from interface:ScalarTokenSequence
Indicates whether the specified token has a zero value.- Specified by:
isZero
in interfaceScalarTokenSequence
- Parameters:
index
- the index of the token- Returns:
true
if the element is zero,false
otherwise
-
setTimestamp
public void setTimestamp(int index, Timestamp value)
Sets the token at the specified position to a timestamp value specified as ajava.sql.Timestamp
object, relative to the default time zone. The time zone returned byTimeZone.getDefault()
is used.- Parameters:
index
- the position of the token in the arrayvalue
- the timestamp value to which to set the token, expressed as a point in time relative to the default time zone. Passingnull
is equivalent tosetNull(index)
.
-
setTimestamp
public void setTimestamp(int index, Timestamp value, TimeZone tz)
Sets the token at the specified position to a timestamp value specified as ajava.sql.Timestamp
object, relative to the given time zone.- Parameters:
index
- the position of the token in the arrayvalue
- the timestamp value to which to set the token, expressed as a point in time relative to the given time zone. Passingnull
is equivalent tosetNull(index)
.tz
- the time zone in which the timestamp should be interpreted
-
fillTimestamp
public void fillTimestamp(int start, int length, Timestamp value)
Sets the tokens in the specified subsequence to a timestamp value specified as ajava.sql.Timestamp
object, relative to the default time zone. The time zone returned byTimeZone.getDefault()
is used.- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequencevalue
- the timestamp value to which to set the tokens, expressed as a point in time relative to the default time zone. Passingnull
is equivalent tosetNull(start, length)
.
-
fillTimestamp
public void fillTimestamp(int start, int length, Timestamp value, TimeZone tz)
Sets the tokens in the specified subsequence to a timestamp value specified as ajava.sql.Timestamp
object, relative to the given time zone.- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequencevalue
- the timestamp value to which to set the tokens, expressed as a point in time relative to the given time zone. Passingnull
is equivalent tosetNull(start, length)
.tz
- the time zone in which the timestamp should be interpreted
-
setEpochSeconds
public void setEpochSeconds(int index, long seconds, int nanos, int offsetSeconds)
Sets the token at the specified position to a timestamp value specified as time since Java epoch (January 1, 1970 00:00:00 GMT) with time zone and daylight saving time offset.- Specified by:
setEpochSeconds
in interfaceMutableTimestampTokenSequence
- Parameters:
index
- the position of the token in the arrayseconds
- number of seconds since Java epochnanos
- fractional portion of epoch time in nanosecondsoffsetSeconds
- time zone and daylight saving time offset, in seconds
-
fillEpochSeconds
public void fillEpochSeconds(int start, int length, long seconds, int nanos, int offsetSeconds)
Sets the tokens in the specified subsequence to a timestamp value specified as time since Java epoch (January 1, 1970 00:00:00 GMT) with time zone and daylight saving time offset.- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequenceseconds
- number of seconds since Java epochnanos
- fractional portion of epoch time in nanosecondsoffsetSeconds
- time zone and daylight saving time offset, in seconds
-
setValue
public void setValue(int index, TokenValued value)
Description copied from interface:MutableTokenSequence
Sets the token at the specified position to the given value.- Specified by:
setValue
in interfaceMutableTokenSequence
- Parameters:
index
- the position of the token in the arrayvalue
- the value to which to set the token. This value must be of an appropriate type for the array.
-
fillValue
public void fillValue(int start, int length, TokenValued value)
Description copied from interface:MutableTokenSequence
Sets the tokens in the specified subsequence to the given value.- Specified by:
fillValue
in interfaceMutableTokenSequence
- Parameters:
start
- the starting index of the subsequence in the arraylength
- the length of the subsequencevalue
- the value to which to set the tokens. This value must be of an appropriate type for the array
-
setValues
public void setValues(int start, TokenSequence values, int offset, int length)
Description copied from interface:MutableTokenSequence
Sets the tokens in the specified subsequence of the array to the corresponding values from a subsequence of the given source sequence.- Specified by:
setValues
in interfaceMutableTokenSequence
- Parameters:
start
- the starting index of the subsequence in the arrayvalues
- the source sequence. This sequence must be of an appropriate type for the array.offset
- the starting index in the source sequence. Corresponding values will be taken relative to this position. That is, the value of the token at positionoffset
invalues
will be assigned to the token at positionstart
, and so on.length
- the number of tokens to copy
-
append
public void append(Timestamp value)
Description copied from interface:MutableTimestampTokenSequence
Appends the specified timestamp to this sequence.- Specified by:
append
in interfaceMutableTimestampTokenSequence
- Parameters:
value
- the value to append. Ifnull
, this is equivalent toappendNull()
.
-
append
public void append(Timestamp value, int count)
Description copied from interface:MutableTimestampTokenSequence
Appends the specified timestamp to this sequence multiple times.- Specified by:
append
in interfaceMutableTimestampTokenSequence
- Parameters:
value
- the value to append. Ifnull
, this is equivalent toappendNull()
.count
- the number of copies to append.
-
appendEpochTime
public void appendEpochTime(long epochSeconds, int subsecondNanos, int offsetSeconds)
Description copied from interface:MutableTimestampTokenSequence
Appends the timestamp specified in epoch time to this sequence.- Specified by:
appendEpochTime
in interfaceMutableTimestampTokenSequence
- Parameters:
epochSeconds
- the number of seconds elapsed since January 1, 1970 00:00:00 GMT.subsecondNanos
- the subsecond portion of the timestamp in nanoseconds.offsetSeconds
- the offset in seconds, including both time zone and daylight savings adjustments, from GMT.
-
appendEpochTime
public void appendEpochTime(long epochSeconds, int subsecondNanos, int offsetSeconds, int count)
Description copied from interface:MutableTimestampTokenSequence
Appends the timestamp specified in epoch time to this sequence multiple times.- Specified by:
appendEpochTime
in interfaceMutableTimestampTokenSequence
- Parameters:
epochSeconds
- the number of seconds elapsed since January 1, 1970 00:00:00 GMT.subsecondNanos
- the subsecond portion of the timestamp in nanoseconds.offsetSeconds
- the offset in seconds, including both time zone and daylight savings adjustments, from GMT.count
- the number of copies to append.
-
newValueIterator
public TimestampValuedIterator newValueIterator()
Description copied from interface:TokenSequence
Creates an iterator over the non-null values of this sequence. The iterator will automatically be reset as modifications are made to the sequence.- Specified by:
newValueIterator
in interfaceScalarTokenSequence
- Specified by:
newValueIterator
in interfaceTimestampTokenSequence
- Specified by:
newValueIterator
in interfaceTokenSequence
- Returns:
- an newly-created iterator over the non-null values of this sequence.
-
-