InstantColumn (tablesaw-core 0.38.5 API)

java.lang.Object
- tech.tablesaw.columns.AbstractColumn<InstantColumn,Instant>
- - tech.tablesaw.api.InstantColumn

All Implemented Interfaces:

Iterable<Instant>, Comparator<Instant>, CategoricalColumn<Instant>, Column<Instant>, InstantMapFunctions, TemporalColumn<Instant>, TemporalFillers<Instant,InstantColumn>, TemporalFilters<Instant>, TemporalMapFunctions<Instant>, FilterSpec<Instant>, InstantFilterSpec<Instant>
```
public class InstantColumn
extends AbstractColumn<InstantColumn,Instant>
implements InstantMapFunctions, TemporalFillers<Instant,InstantColumn>, TemporalFilters<Instant>, CategoricalColumn<Instant>
```
A column in a table that contains long-integer encoded (packed) local date-time values

Field Summary

Fields
Modifier and Type Field Description

protected it.unimi.dsi.fastutil.longs.LongArrayList data
- Fields inherited from class tech.tablesaw.columns.AbstractColumn
  DEFAULT_ARRAY_SIZE

Fields
Modifier and Type	Field	Description
`protected it.unimi.dsi.fastutil.longs.LongArrayList`	`data`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`InstantColumn`	`append(Instant dateTime)`
`InstantColumn`	`append(Column<Instant> column)`
`InstantColumn`	`append(Column<Instant> column, int row)`
`InstantColumn`	`appendCell(String stringValue)`
`InstantColumn`	`appendCell(String stringValue, AbstractColumnParser<?> parser)`
`InstantColumn`	`appendInternal(long dateTime)`
`InstantColumn`	`appendMissing()`	Appends a missing value appropriate to the column
`InstantColumn`	`appendObj(Object obj)`
`byte[]`	`asBytes(int rowNumber)`	Returns the contents of the cell at rowNumber as a byte[]
`double[]`	`asDoubleArray()`
`DoubleColumn`	`asDoubleColumn()`
`long[]`	`asEpochMillisArray()`	Returns an array where each entry is the difference, measured in milliseconds, between the Instant and midnight, January 1, 1970 UTC.
`long[]`	`asEpochMillisArray(ZoneOffset offset)`	Returns an array where each entry is the difference, measured in milliseconds, between the Instant and midnight, January 1, 1970 UTC.
`long[]`	`asEpochSecondArray()`	Returns an array where each entry is the difference, measured in seconds, between the Instant and midnight, January 1, 1970 UTC.
`long[]`	`asEpochSecondArray(ZoneOffset offset)`	Returns the seconds from epoch for each value as an array based on the given offset
`DateTimeColumn`	`asLocalDateTimeColumn()`
`DateTimeColumn`	`asLocalDateTimeColumn(ZoneId zone)`
`Instant[]`	`asObjectArray()`
`Set<Instant>`	`asSet()`
`List<Instant>`	`bottom(int n)`	Returns the smallest ("bottom") n values in the column
`int`	`byteSize()`	Returns the width of a cell in this column, in bytes.
`void`	`clear()`
`int`	`compare(Instant o1, Instant o2)`
`boolean`	`contains(Instant dateTime)`	Returns `true` if the given object appears in this column, and false otherwise
`InstantColumn`	`copy()`	Returns a deep copy of the receiver
`int`	`countMissing()`	Returns the count of missing values in this column
`int`	`countUnique()`	Returns the count of unique values in this column.
`static InstantColumn`	`create(String name)`
`static InstantColumn`	`create(String name, int initialSize)`
`static InstantColumn`	`create(String name, Instant... data)`
`static InstantColumn`	`create(String name, Collection<Instant> data)`
`static InstantColumn`	`create(String name, Stream<Instant> stream)`
`static InstantColumn`	`createInternal(String name, long[] data)`	For internal Tablesaw use only Returns a new column with the given name and data
`InstantColumn`	`emptyCopy()`	Returns a copy of the receiver with no data.
`InstantColumn`	`emptyCopy(int rowSize)`	Returns an empty copy of the receiver, with its internal storage initialized to the given row size.
`InstantColumn`	`fillWith(Iterable<Instant> iterable)`
`InstantColumn`	`fillWith(Supplier<Instant> supplier)`
`InstantColumn`	`fillWith(Iterator<Instant> iterator)`
`Instant`	`get(int index)`
`double`	`getDouble(int i)`
`long`	`getLongInternal(int index)`
`protected long`	`getPackedDateTime(int index)`
`String`	`getString(int row)`	Returns a string representation of the value at the given row.
`String`	`getUnformattedString(int row)`
`boolean`	`isEmpty()`	Returns true if the column has no data
`Selection`	`isMissing()`
`boolean`	`isMissing(int rowNumber)`
`Selection`	`isNotMissing()`
`Iterator<Instant>`	`iterator()`	Returns an iterator over elements of type `T`.
`InstantColumn`	`lag(int n)`	Returns a column of the same type and size as the receiver, containing the receivers values offset by n.
`it.unimi.dsi.fastutil.longs.LongIterator`	`longIterator()`
`Instant`	`max()`
`Instant`	`min()`
`InstantColumn`	`plus(long amountToAdd, ChronoUnit unit)`
`InstantColumn`	`removeMissing()`
`it.unimi.dsi.fastutil.ints.IntComparator`	`rowComparator()`
`InstantColumn`	`set(int index, long value)`
`InstantColumn`	`set(int index, Instant value)`
`InstantColumn`	`set(int row, Column<Instant> column, int sourceRow)`
`InstantColumn`	`set(Selection rowSelection, Instant newValue)`	Conditionally update this column, replacing current values with newValue for all rows where the current value matches the selection criteria
`InstantColumn`	`setMissing(int i)`
`void`	`setPrintFormatter(InstantColumnFormatter formatter)`
`int`	`size()`
`void`	`sortAscending()`
`void`	`sortDescending()`
`InstantColumn`	`subset(int[] rows)`
`Table`	`summary()`
`List<Instant>`	`top(int n)`	Returns the largest ("top") n values in the column
`InstantColumn`	`unique()`	Returns a column of the same type as the receiver, containing only the unique values of the receiver.
`static boolean`	`valueIsMissing(long value)`
`InstantColumn`	`where(Selection selection)`

Methods inherited from class tech.tablesaw.columns.AbstractColumn
asStringColumn, filter, first, indexOf, inRange, last, map, max, min, name, parser, sampleN, sampleX, set, setName, setParser, sorted, toString, type

Methods inherited from interface tech.tablesaw.api.CategoricalColumn
countByCategory

Methods inherited from interface tech.tablesaw.columns.Column
allMatch, anyMatch, asList, asStringColumn, columnWidth, count, count, filter, first, indexOf, inRange, interpolate, last, lead, map, map, mapInto, max, max, min, min, name, noneMatch, parser, print, reduce, reduce, rolling, sampleN, sampleX, set, set, set, setMissingTo, setName, setParser, sorted, title, type

Methods inherited from interface java.util.Comparator
comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Methods inherited from interface tech.tablesaw.columns.instant.InstantMapFunctions
plusDays, plusHours, plusMicros, plusMillis, plusMinutes, plusMonths, plusSeconds, plusWeeks, plusYears

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface tech.tablesaw.columns.temporal.TemporalFilters
eval, eval, eval, eval, eval, isAfter, isBefore, isBetweenExcluding, isBetweenIncluding, isEqualTo

Methods inherited from interface tech.tablesaw.columns.temporal.TemporalMapFunctions
difference, differenceInDays, differenceInHours, differenceInMilliseconds, differenceInMinutes, differenceInSeconds, differenceInYears, missingValues, temporalColumnName

- Field Detail
  - data
```
protected it.unimi.dsi.fastutil.longs.LongArrayList data
```
- Method Detail
  - create
```
public static InstantColumn create(String name)
```
  - createInternal
```
public static InstantColumn createInternal(String name,
                                           long[] data)
```
    For internal Tablesaw use only Returns a new column with the given name and data
    
    Parameters:
    
    name - The column name
    
    data - An array of longs representing Instant values in Tablesaw internal format
  - create
```
public static InstantColumn create(String name,
                                   int initialSize)
```
  - create
```
public static InstantColumn create(String name,
                                   Collection<Instant> data)
```
  - create
```
public static InstantColumn create(String name,
                                   Instant... data)
```
  - create
```
public static InstantColumn create(String name,
                                   Stream<Instant> stream)
```
  - valueIsMissing
```
public static boolean valueIsMissing(long value)
```
  - isMissing
```
public boolean isMissing(int rowNumber)
```
    Specified by:
    
    isMissing in interface Column<Instant>
  - plus
```
public InstantColumn plus(long amountToAdd,
                          ChronoUnit unit)
```
    Specified by:
    
    plus in interface InstantMapFunctions
    
    Specified by:
    
    plus in interface TemporalMapFunctions<Instant>
  - subset
```
public InstantColumn subset(int[] rows)
```
    Specified by:
    
    subset in interface Column<Instant>
    
    Overrides:
    
    subset in class AbstractColumn<InstantColumn,Instant>
  - removeMissing
```
public InstantColumn removeMissing()
```
    Specified by:
    
    removeMissing in interface Column<Instant>
  - contains
```
public boolean contains(Instant dateTime)
```
    Description copied from interface: Column
    
    Returns true if the given object appears in this column, and false otherwise
    TODO override in column subtypes for performance
    
    Specified by:
    
    contains in interface Column<Instant>
  - setMissing
```
public InstantColumn setMissing(int i)
```
    Specified by:
    
    setMissing in interface Column<Instant>
  - where
```
public InstantColumn where(Selection selection)
```
    Specified by:
    
    where in interface Column<Instant>
  - setPrintFormatter
```
public void setPrintFormatter(InstantColumnFormatter formatter)
```
  - lag
```
public InstantColumn lag(int n)
```
    Description copied from interface: Column
    
    Returns a column of the same type and size as the receiver, containing the receivers values offset by n.
    For example if you lag a column containing 2, 3, 4 by 1, you get a column containing NA, 2, 3
    
    Specified by:
    
    lag in interface Column<Instant>
  - appendCell
```
public InstantColumn appendCell(String stringValue)
```
    Specified by:
    
    appendCell in interface Column<Instant>
  - appendCell
```
public InstantColumn appendCell(String stringValue,
                                AbstractColumnParser<?> parser)
```
    Specified by:
    
    appendCell in interface Column<Instant>
  - append
```
public InstantColumn append(Instant dateTime)
```
    Specified by:
    
    append in interface Column<Instant>
  - appendObj
```
public InstantColumn appendObj(Object obj)
```
    Specified by:
    
    appendObj in interface Column<Instant>
  - size
```
public int size()
```
    Specified by:
    
    size in interface Column<Instant>
    
    Specified by:
    
    size in interface TemporalFilters<Instant>
  - appendInternal
```
public InstantColumn appendInternal(long dateTime)
```
    Specified by:
    
    appendInternal in interface TemporalColumn<Instant>
  - getString
```
public String getString(int row)
```
    Description copied from interface: Column
    
    Returns a string representation of the value at the given row.
    
    Specified by:
    
    getString in interface Column<Instant>
    
    Parameters:
    
    row - The index of the row.
    
    Returns:
    
    value as String
  - getUnformattedString
```
public String getUnformattedString(int row)
```
    Specified by:
    
    getUnformattedString in interface Column<Instant>
  - emptyCopy
```
public InstantColumn emptyCopy()
```
    Description copied from interface: Column
    
    Returns a copy of the receiver with no data. The column name and type are the same.
    
    Specified by:
    
    emptyCopy in interface Column<Instant>
    
    Specified by:
    
    emptyCopy in interface TemporalMapFunctions<Instant>
    
    Specified by:
    
    emptyCopy in class AbstractColumn<InstantColumn,Instant>
    
    Returns:
    
    a empty copy of Column
  - emptyCopy
```
public InstantColumn emptyCopy(int rowSize)
```
    Description copied from interface: Column
    
    Returns an empty copy of the receiver, with its internal storage initialized to the given row size.
    
    Specified by:
    
    emptyCopy in interface Column<Instant>
    
    Parameters:
    
    rowSize - the initial row size
    
    Returns:
    
    a Column
  - copy
```
public InstantColumn copy()
```
    Description copied from interface: Column
    
    Returns a deep copy of the receiver
    
    Specified by:
    
    copy in interface Column<Instant>
    
    Returns:
    
    a Column
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Column<Instant>
  - sortAscending
```
public void sortAscending()
```
    Specified by:
    
    sortAscending in interface Column<Instant>
  - sortDescending
```
public void sortDescending()
```
    Specified by:
    
    sortDescending in interface Column<Instant>
  - summary
```
public Table summary()
```
    Specified by:
    
    summary in interface Column<Instant>
  - countUnique
```
public int countUnique()
```
    Description copied from interface: Column
    
    Returns the count of unique values in this column.
    
    Specified by:
    
    countUnique in interface Column<Instant>
    
    Returns:
    
    unique values as int
  - unique
```
public InstantColumn unique()
```
    Description copied from interface: Column
    
    Returns a column of the same type as the receiver, containing only the unique values of the receiver.
    
    Specified by:
    
    unique in interface Column<Instant>
    
    Returns:
    
    a Column
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from interface: Column
    
    Returns true if the column has no data
    
    Specified by:
    
    isEmpty in interface Column<Instant>
    
    Returns:
    
    true if empty, false if not
  - getLongInternal
```
public long getLongInternal(int index)
```
    Specified by:
    
    getLongInternal in interface TemporalColumn<Instant>
    
    Specified by:
    
    getLongInternal in interface TemporalFilters<Instant>
  - getPackedDateTime
```
protected long getPackedDateTime(int index)
```
  - get
```
public Instant get(int index)
```
    Specified by:
    
    get in interface Column<Instant>
    
    Specified by:
    
    get in interface TemporalColumn<Instant>
    
    Specified by:
    
    get in interface TemporalFilters<Instant>
  - rowComparator
```
public it.unimi.dsi.fastutil.ints.IntComparator rowComparator()
```
    Specified by:
    
    rowComparator in interface Column<Instant>
  - set
```
public InstantColumn set(Selection rowSelection,
                         Instant newValue)
```
    Conditionally update this column, replacing current values with newValue for all rows where the current value matches the selection criteria
    Example: myColumn.set(myColumn.valueIsMissing(), Instant.now()); // no more missing values
    
    Specified by:
    
    set in interface Column<Instant>
    
    Overrides:
    
    set in class AbstractColumn<InstantColumn,Instant>
  - countMissing
```
public int countMissing()
```
    Returns the count of missing values in this column
    
    Specified by:
    
    countMissing in interface Column<Instant>
    
    Returns:
    
    missing values as int
  - asEpochSecondArray
```
public long[] asEpochSecondArray()
```
    Returns an array where each entry is the difference, measured in seconds, between the Instant and midnight, January 1, 1970 UTC.
    If a value is missing, InstantColumnType.missingValueIndicator() is used
  - asEpochSecondArray
```
public long[] asEpochSecondArray(ZoneOffset offset)
```
    Returns the seconds from epoch for each value as an array based on the given offset
    If a value is missing, InstantColumnType.missingValueIndicator() is used
  - asEpochMillisArray
```
public long[] asEpochMillisArray()
```
    Returns an array where each entry is the difference, measured in milliseconds, between the Instant and midnight, January 1, 1970 UTC.
    If a missing value is encountered, InstantColumnType.missingValueIndicator() is inserted in the array
  - asEpochMillisArray
```
public long[] asEpochMillisArray(ZoneOffset offset)
```
    Returns an array where each entry is the difference, measured in milliseconds, between the Instant and midnight, January 1, 1970 UTC.
    If a missing value is encountered, InstantColumnType.missingValueIndicator() is inserted in the array
  - asLocalDateTimeColumn
```
public DateTimeColumn asLocalDateTimeColumn()
```
  - asLocalDateTimeColumn
```
public DateTimeColumn asLocalDateTimeColumn(ZoneId zone)
```
  - append
```
public InstantColumn append(Column<Instant> column)
```
    Specified by:
    
    append in interface Column<Instant>
  - append
```
public InstantColumn append(Column<Instant> column,
                            int row)
```
    Specified by:
    
    append in interface Column<Instant>
  - set
```
public InstantColumn set(int row,
                         Column<Instant> column,
                         int sourceRow)
```
    Specified by:
    
    set in interface Column<Instant>
  - max
```
public Instant max()
```
  - appendMissing
```
public InstantColumn appendMissing()
```
    Description copied from interface: Column
    
    Appends a missing value appropriate to the column
    
    Specified by:
    
    appendMissing in interface Column<Instant>
  - min
```
public Instant min()
```
    Specified by:
    
    min in interface TemporalMapFunctions<Instant>
  - set
```
public InstantColumn set(int index,
                         long value)
```
  - set
```
public InstantColumn set(int index,
                         Instant value)
```
    Specified by:
    
    set in interface Column<Instant>
  - top
```
public List<Instant> top(int n)
```
    Returns the largest ("top") n values in the column
    
    Parameters:
    
    n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column
    
    Returns:
    
    A list, possibly empty, of the largest observations
  - bottom
```
public List<Instant> bottom(int n)
```
    Returns the smallest ("bottom") n values in the column
    
    Parameters:
    
    n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column
    
    Returns:
    
    A list, possibly empty, of the smallest n observations
  - longIterator
```
public it.unimi.dsi.fastutil.longs.LongIterator longIterator()
```
  - asSet
```
public Set<Instant> asSet()
```
  - byteSize
```
public int byteSize()
```
    Description copied from interface: Column
    
    Returns the width of a cell in this column, in bytes.
    
    Specified by:
    
    byteSize in interface Column<Instant>
    
    Returns:
    
    width in bytes
  - asBytes
```
public byte[] asBytes(int rowNumber)
```
    Returns the contents of the cell at rowNumber as a byte[]
    
    Specified by:
    
    asBytes in interface Column<Instant>
    
    Parameters:
    
    rowNumber - index of the row
    
    Returns:
    
    content as byte[]
  - getDouble
```
public double getDouble(int i)
```
  - asDoubleArray
```
public double[] asDoubleArray()
```
  - asDoubleColumn
```
public DoubleColumn asDoubleColumn()
```
  - iterator
```
public Iterator<Instant> iterator()
```
    Returns an iterator over elements of type T.
    
    Specified by:
    
    iterator in interface Iterable<Instant>
    
    Returns:
    
    an Iterator.
  - fillWith
```
public InstantColumn fillWith(Iterator<Instant> iterator)
```
    Specified by:
    
    fillWith in interface TemporalFillers<Instant,InstantColumn>
  - fillWith
```
public InstantColumn fillWith(Iterable<Instant> iterable)
```
    Specified by:
    
    fillWith in interface TemporalFillers<Instant,InstantColumn>
  - fillWith
```
public InstantColumn fillWith(Supplier<Instant> supplier)
```
    Specified by:
    
    fillWith in interface TemporalFillers<Instant,InstantColumn>
  - asObjectArray
```
public Instant[] asObjectArray()
```
    Specified by:
    
    asObjectArray in interface Column<Instant>
  - compare
```
public int compare(Instant o1,
                   Instant o2)
```
    Specified by:
    
    compare in interface Comparator<Instant>
  - isMissing
```
public Selection isMissing()
```
    Specified by:
    
    isMissing in interface Column<Instant>
    
    Specified by:
    
    isMissing in interface FilterSpec<Instant>
    
    Specified by:
    
    isMissing in interface TemporalFilters<Instant>
  - isNotMissing
```
public Selection isNotMissing()
```
    Specified by:
    
    isNotMissing in interface Column<Instant>
    
    Specified by:
    
    isNotMissing in interface FilterSpec<Instant>
    
    Specified by:
    
    isNotMissing in interface TemporalFilters<Instant>

Class InstantColumn

Field Summary

Fields inherited from class tech.tablesaw.columns.AbstractColumn

Method Summary

Methods inherited from class tech.tablesaw.columns.AbstractColumn

Methods inherited from interface tech.tablesaw.api.CategoricalColumn

Methods inherited from interface tech.tablesaw.columns.Column

Methods inherited from interface java.util.Comparator

Methods inherited from interface tech.tablesaw.columns.instant.InstantMapFunctions

Methods inherited from interface java.lang.Iterable

Methods inherited from class java.lang.Object

Methods inherited from interface tech.tablesaw.columns.temporal.TemporalFilters

Methods inherited from interface tech.tablesaw.columns.temporal.TemporalMapFunctions

Field Detail

data

Method Detail

create

createInternal

create

create

create

create

valueIsMissing

isMissing

plus

subset

removeMissing

contains

setMissing

where

setPrintFormatter

lag

appendCell

appendCell

append

appendObj

size

appendInternal

getString

getUnformattedString

emptyCopy

emptyCopy

copy

clear

sortAscending

sortDescending

summary

countUnique

unique

isEmpty

getLongInternal

getPackedDateTime

get

rowComparator

set

countMissing

asEpochSecondArray

asEpochSecondArray

asEpochMillisArray

asEpochMillisArray

asLocalDateTimeColumn

asLocalDateTimeColumn

append

append

set

max

appendMissing

min

set

set

top

bottom

longIterator

asSet

byteSize

asBytes

getDouble

asDoubleArray

asDoubleColumn

iterator