DateColumn (tablesaw-core 0.32.1 API)

java.lang.Object
- tech.tablesaw.columns.AbstractColumn<LocalDate>
- - tech.tablesaw.api.DateColumn

All Implemented Interfaces:

Iterable<LocalDate>, Comparator<LocalDate>, CategoricalColumn<LocalDate>, Column<LocalDate>, DateFillers<DateColumn>, DateFilters, DateMapFunctions
```
public class DateColumn
extends AbstractColumn<LocalDate>
implements DateFilters, DateFillers<DateColumn>, DateMapFunctions, CategoricalColumn<LocalDate>
```
A column in a base table that contains float values

Field Summary
- Fields inherited from class tech.tablesaw.columns.AbstractColumn
  DEFAULT_ARRAY_SIZE

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`DateColumn`	`append(Column<LocalDate> column)`
`DateColumn`	`append(Column<LocalDate> column, int row)`
`DateColumn`	`append(LocalDate value)`
`DateColumn`	`appendCell(String string)`
`DateColumn`	`appendCell(String string, AbstractColumnParser<?> parser)`
`DateColumn`	`appendInternal(int f)`
`DateColumn`	`appendMissing()` Appends a missing value appropriate to the column
`DateColumn`	`appendObj(Object obj)`
`byte[]`	`asBytes(int rowNumber)` Returns the contents of the cell at rowNumber as a byte[]
`double[]`	`asDoubleArray()`
`DoubleColumn`	`asDoubleColumn()`
`List<LocalDate>`	`asList()` Returns a list of all the elements in this column Note, if a value in the column is missing, a `null` is added in it's place
`LocalDate[]`	`asObjectArray()`
`Set<LocalDate>`	`asSet()`
`List<LocalDate>`	`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(LocalDate o1, LocalDate o2)`
`boolean`	`contains(LocalDate localDate)` Returns `true` if the given object appears in this column, and false otherwise TODO override in column subtypes for performance
`DateColumn`	`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 DateColumn`	`create(String name)`
`static DateColumn`	`create(String name, int initialSize)`
`static DateColumn`	`create(String name, List<LocalDate> data)`
`static DateColumn`	`create(String name, LocalDate[] data)`
`it.unimi.dsi.fastutil.ints.IntArrayList`	`data()`
`DateColumn`	`emptyCopy()` Returns a copy of the receiver with no data.
`DateColumn`	`emptyCopy(int rowSize)` Returns an empty copy of the receiver, with its internal storage initialized to the given row size.
`DateColumn`	`fillWith(Iterable<LocalDate> iterable)`
`DateColumn`	`fillWith(Iterator<LocalDate> iterator)`
`DateColumn`	`fillWith(Supplier<LocalDate> supplier)`
`DateColumn`	`filter(Predicate<? super LocalDate> test)` Returns a new Column of the same type with only those rows satisfying the predicate
`DateColumn`	`first(int numRows)`
`LocalDate`	`get(int index)`
`double`	`getDouble(int i)`
`int`	`getIntInternal(int index)`
`protected int`	`getPackedDate(int index)`
`String`	`getString(int row)` Returns a string representation of the value at the given row.
`String`	`getUnformattedString(int row)`
`DateColumn`	`inRange(int start, int end)` Returns a column containing the rows in this column beginning with start inclusive, and ending with end exclusive
`it.unimi.dsi.fastutil.ints.IntIterator`	`intIterator()`
`boolean`	`isEmpty()` Returns true if the column has no data
`boolean`	`isMissing(int rowNumber)`
`Iterator<LocalDate>`	`iterator()` Returns an iterator over elements of type `T`.
`DateColumn`	`lag(int n)` Returns a column of the same type and size as the receiver, containing the receivers values offset by n.
`DateColumn`	`last(int numRows)`
`DateColumn`	`lead(int n)` Returns a column of the same type as the receiver, containing the receivers values offset -n For example if you lead a column containing 2, 3, 4 by 1, you get a column containing 3, 4, NA.
`DateColumn`	`map(Function<? super LocalDate,? extends LocalDate> fun)` Maps the function across all rows, appending the results to a new Column of the same type
`LocalDate`	`max()`
`DateColumn`	`max(Column<LocalDate> other)` Returns a column containing the element-wise min between this column and other column TODO(lwhite) Override in column subtypes for better performance
`LocalDate`	`min()`
`DateColumn`	`min(Column<LocalDate> other)` Returns a column containing the element-wise min between this column and other column TODO(lwhite) Override in column subtypes for better performance
`DateColumn`	`removeMissing()`
`it.unimi.dsi.fastutil.ints.IntComparator`	`rowComparator()`
`DateColumn`	`sampleN(int n)` Returns a column containing a random sample of the values in this column
`DateColumn`	`sampleX(double proportion)` Returns a table consisting of randomly selected values from this column.
`DateColumn`	`set(int row, Column<LocalDate> column, int sourceRow)`
`DateColumn`	`set(int index, int value)`
`DateColumn`	`set(int index, LocalDate value)`
`DateColumn`	`set(Selection condition, Column<LocalDate> other)` Updates this column where values matching the selection are replaced with the corresponding value from the given column
`DateColumn`	`set(Selection rowSelection, LocalDate newValue)` Conditionally update this column, replacing current values with newValue for all rows where the current value matches the selection criteria
`Column<LocalDate>`	`setMissing(int i)`
`DateColumn`	`setName(String name)` Sets the columns name to the given string
`void`	`setPrintFormatter(DateTimeFormatter dateTimeFormatter)`
`void`	`setPrintFormatter(DateTimeFormatter dateTimeFormatter, String missingValueString)`
`int`	`size()`
`void`	`sortAscending()`
`void`	`sortDescending()`
`DateColumn`	`sorted(Comparator<? super LocalDate> comp)` Returns a new Column of the same type sorted according to the provided Comparator
`DateColumn`	`subset(int[] rows)`
`Table`	`summary()` Returns a table of dates and the number of observations of those dates
`List<LocalDate>`	`top(int n)` Returns the largest ("top") n values in the column
`DateColumn`	`unique()` Returns a column of the same type as the receiver, containing only the unique values of the receiver.
`static boolean`	`valueIsMissing(int i)`
`DateColumn`	`where(Selection selection)`

Methods inherited from class tech.tablesaw.columns.AbstractColumn
asStringColumn, name, toString, type

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

Methods inherited from interface tech.tablesaw.columns.dates.DateFilters
eval, eval, eval, eval, eval, isAfter, isAfter, isAfter, isBefore, isBefore, isBefore, isBetweenExcluding, isBetweenExcluding, isBetweenIncluding, isBetweenIncluding, isEqualTo, isEqualTo, isEqualTo, isFirstDayOfMonth, isFriday, isInApril, isInAugust, isInDecember, isInFebruary, isInJanuary, isInJuly, isInJune, isInMarch, isInMay, isInNovember, isInOctober, isInQ1, isInQ2, isInQ3, isInQ4, isInSeptember, isInYear, isLastDayOfMonth, isMissing, isMonday, isNotEqualTo, isNotMissing, isOnOrAfter, isOnOrAfter, isOnOrBefore, isOnOrBefore, isSaturday, isSunday, isThursday, isTuesday, isWednesday

Methods inherited from interface tech.tablesaw.columns.dates.DateMapFunctions
atStartOfDay, atTime, atTime, dateColumnName, dayOfMonth, dayOfWeek, dayOfWeekValue, dayOfYear, daysUntil, minus, minusDays, minusMonths, minusWeeks, minusYears, month, monthsUntil, monthValue, plus, plusDays, plusMonths, plusWeeks, plusYears, timeUntil, timeWindow, timeWindow, weeksUntil, year, yearDay, yearMonth, yearQuarter, yearsUntil, yearWeek

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

Methods inherited from interface tech.tablesaw.columns.Column
allMatch, anyMatch, asStringColumn, columnWidth, count, count, mapInto, max, min, name, noneMatch, print, reduce, reduce, rolling, title, type

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

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

- Method Detail
  - create
```
public static DateColumn create(String name)
```
  - create
```
public static DateColumn create(String name,
                                int initialSize)
```
  - create
```
public static DateColumn create(String name,
                                List<LocalDate> data)
```
  - create
```
public static DateColumn create(String name,
                                LocalDate[] data)
```
  - size
```
public int size()
```
    Specified by:
    
    size in interface Column<LocalDate>
  - subset
```
public DateColumn subset(int[] rows)
```
    Specified by:
    
    subset in interface Column<LocalDate>
  - appendInternal
```
public DateColumn appendInternal(int f)
```
  - data
```
public it.unimi.dsi.fastutil.ints.IntArrayList data()
```
    Specified by:
    
    data in interface DateFilters
  - set
```
public DateColumn set(int index,
                      int value)
```
  - set
```
public DateColumn set(int index,
                      LocalDate value)
```
    Specified by:
    
    set in interface Column<LocalDate>
  - setPrintFormatter
```
public void setPrintFormatter(DateTimeFormatter dateTimeFormatter,
                              String missingValueString)
```
  - setPrintFormatter
```
public void setPrintFormatter(DateTimeFormatter dateTimeFormatter)
```
  - 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<LocalDate>
    
    Parameters:
    
    row - The index of the row.
    
    Returns:
    
    value as String
  - getUnformattedString
```
public String getUnformattedString(int row)
```
    Specified by:
    
    getUnformattedString in interface Column<LocalDate>
  - emptyCopy
```
public DateColumn 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<LocalDate>
    
    Specified by:
    
    emptyCopy in class AbstractColumn<LocalDate>
    
    Returns:
    
    a empty copy of Column
  - emptyCopy
```
public DateColumn 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<LocalDate>
    
    Parameters:
    
    rowSize - the initial row size
    
    Returns:
    
    a Column
  - copy
```
public DateColumn copy()
```
    Description copied from interface: Column
    
    Returns a deep copy of the receiver
    
    Specified by:
    
    copy in interface Column<LocalDate>
    
    Returns:
    
    a Column
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Column<LocalDate>
  - lead
```
public DateColumn lead(int n)
```
    Description copied from interface: Column
    
    Returns a column of the same type as the receiver, containing the receivers values offset -n For example if you lead a column containing 2, 3, 4 by 1, you get a column containing 3, 4, NA.
    
    Specified by:
    
    lead in interface Column<LocalDate>
  - lag
```
public DateColumn 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<LocalDate>
  - sortAscending
```
public void sortAscending()
```
    Specified by:
    
    sortAscending in interface Column<LocalDate>
  - sortDescending
```
public void sortDescending()
```
    Specified by:
    
    sortDescending in interface Column<LocalDate>
  - countUnique
```
public int countUnique()
```
    Description copied from interface: Column
    
    Returns the count of unique values in this column.
    
    Specified by:
    
    countUnique in interface Column<LocalDate>
    
    Returns:
    
    unique values as int
  - unique
```
public DateColumn 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<LocalDate>
    
    Returns:
    
    a Column
  - append
```
public DateColumn append(Column<LocalDate> column)
```
    Specified by:
    
    append in interface Column<LocalDate>
  - append
```
public DateColumn append(Column<LocalDate> column,
                         int row)
```
    Specified by:
    
    append in interface Column<LocalDate>
  - set
```
public DateColumn set(int row,
                      Column<LocalDate> column,
                      int sourceRow)
```
    Specified by:
    
    set in interface Column<LocalDate>
  - max
```
public LocalDate max()
```
    Specified by:
    
    max in interface DateMapFunctions
  - min
```
public LocalDate min()
```
    Specified by:
    
    min in interface DateMapFunctions
  - set
```
public DateColumn set(Selection rowSelection,
                      LocalDate 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(), LocalDate.now()); // no more missing values
    
    Specified by:
    
    set in interface Column<LocalDate>
  - appendMissing
```
public DateColumn appendMissing()
```
    Description copied from interface: Column
    
    Appends a missing value appropriate to the column
    
    Specified by:
    
    appendMissing in interface Column<LocalDate>
  - get
```
public LocalDate get(int index)
```
    Specified by:
    
    get in interface Column<LocalDate>
    
    Specified by:
    
    get in interface DateMapFunctions
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from interface: Column
    
    Returns true if the column has no data
    
    Specified by:
    
    isEmpty in interface Column<LocalDate>
    
    Returns:
    
    true if empty, false if not
  - rowComparator
```
public it.unimi.dsi.fastutil.ints.IntComparator rowComparator()
```
    Specified by:
    
    rowComparator in interface Column<LocalDate>
  - append
```
public DateColumn append(LocalDate value)
```
    Specified by:
    
    append in interface Column<LocalDate>
  - appendObj
```
public DateColumn appendObj(Object obj)
```
    Specified by:
    
    appendObj in interface Column<LocalDate>
  - appendCell
```
public DateColumn appendCell(String string)
```
    Specified by:
    
    appendCell in interface Column<LocalDate>
  - appendCell
```
public DateColumn appendCell(String string,
                             AbstractColumnParser<?> parser)
```
    Specified by:
    
    appendCell in interface Column<LocalDate>
  - getIntInternal
```
public int getIntInternal(int index)
```
    Specified by:
    
    getIntInternal in interface DateFilters
    
    Specified by:
    
    getIntInternal in interface DateMapFunctions
  - getPackedDate
```
protected int getPackedDate(int index)
```
  - summary
```
public Table summary()
```
    Returns a table of dates and the number of observations of those dates
    
    Specified by:
    
    summary in interface Column<LocalDate>
    
    Returns:
    
    the summary table
  - valueIsMissing
```
public static boolean valueIsMissing(int i)
```
  - countMissing
```
public int countMissing()
```
    Returns the count of missing values in this column
    
    Specified by:
    
    countMissing in interface Column<LocalDate>
    
    Returns:
    
    missing values as int
  - top
```
public List<LocalDate> 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<LocalDate> 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
  - intIterator
```
public it.unimi.dsi.fastutil.ints.IntIterator intIterator()
```
  - removeMissing
```
public DateColumn removeMissing()
```
    Specified by:
    
    removeMissing in interface Column<LocalDate>
  - asList
```
public List<LocalDate> asList()
```
    Description copied from interface: Column
    
    Returns a list of all the elements in this column Note, if a value in the column is missing, a null is added in it's place
    
    Specified by:
    
    asList in interface Column<LocalDate>
  - where
```
public DateColumn where(Selection selection)
```
    Specified by:
    
    where in interface Column<LocalDate>
    
    Specified by:
    
    where in interface DateFilters
  - asSet
```
public Set<LocalDate> asSet()
```
  - contains
```
public boolean contains(LocalDate localDate)
```
    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<LocalDate>
  - setMissing
```
public Column<LocalDate> setMissing(int i)
```
    Specified by:
    
    setMissing in interface Column<LocalDate>
  - asDoubleArray
```
public double[] asDoubleArray()
```
  - asDoubleColumn
```
public DoubleColumn asDoubleColumn()
```
  - isMissing
```
public boolean isMissing(int rowNumber)
```
    Specified by:
    
    isMissing in interface Column<LocalDate>
  - getDouble
```
public double getDouble(int i)
```
  - 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<LocalDate>
    
    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<LocalDate>
    
    Parameters:
    
    rowNumber - the number of the row as int
    
    Returns:
    
    content as byte[]
  - iterator
```
public Iterator<LocalDate> iterator()
```
    Returns an iterator over elements of type T.
    
    Specified by:
    
    iterator in interface Iterable<LocalDate>
    
    Returns:
    
    an Iterator.
  - fillWith
```
public DateColumn fillWith(Iterator<LocalDate> iterator)
```
    Specified by:
    
    fillWith in interface DateFillers<DateColumn>
  - fillWith
```
public DateColumn fillWith(Iterable<LocalDate> iterable)
```
    Specified by:
    
    fillWith in interface DateFillers<DateColumn>
  - fillWith
```
public DateColumn fillWith(Supplier<LocalDate> supplier)
```
    Specified by:
    
    fillWith in interface DateFillers<DateColumn>
  - asObjectArray
```
public LocalDate[] asObjectArray()
```
    Specified by:
    
    asObjectArray in interface Column<LocalDate>
  - compare
```
public int compare(LocalDate o1,
                   LocalDate o2)
```
    Specified by:
    
    compare in interface Comparator<LocalDate>
  - setName
```
public DateColumn setName(String name)
```
    Description copied from interface: Column
    
    Sets the columns name to the given string
    
    Specified by:
    
    setName in interface Column<LocalDate>
    
    Overrides:
    
    setName in class AbstractColumn<LocalDate>
    
    Parameters:
    
    name - The new name MUST be unique for any table containing this column
    
    Returns:
    
    this Column to allow method chaining
  - filter
```
public DateColumn filter(Predicate<? super LocalDate> test)
```
    Description copied from interface: Column
    
    Returns a new Column of the same type with only those rows satisfying the predicate
    
    Specified by:
    
    filter in interface Column<LocalDate>
    
    Parameters:
    
    test - the predicate
    
    Returns:
    
    a new Column of the same type with only those rows satisfying the predicate
  - sorted
```
public DateColumn sorted(Comparator<? super LocalDate> comp)
```
    Description copied from interface: Column
    
    Returns a new Column of the same type sorted according to the provided Comparator
    
    Specified by:
    
    sorted in interface Column<LocalDate>
    
    Parameters:
    
    comp - the Comparator
    
    Returns:
    
    a sorted Column
  - map
```
public DateColumn map(Function<? super LocalDate,? extends LocalDate> fun)
```
    Description copied from interface: Column
    
    Maps the function across all rows, appending the results to a new Column of the same type
    
    Specified by:
    
    map in interface Column<LocalDate>
    
    Parameters:
    
    fun - function to map
    
    Returns:
    
    the Column with the results
  - min
```
public DateColumn min(Column<LocalDate> other)
```
    Description copied from interface: Column
    
    Returns a column containing the element-wise min between this column and other column TODO(lwhite) Override in column subtypes for better performance
    
    Specified by:
    
    min in interface Column<LocalDate>
  - max
```
public DateColumn max(Column<LocalDate> other)
```
    Description copied from interface: Column
    
    Returns a column containing the element-wise min between this column and other column TODO(lwhite) Override in column subtypes for better performance
    
    Specified by:
    
    max in interface Column<LocalDate>
  - set
```
public DateColumn set(Selection condition,
                      Column<LocalDate> other)
```
    Description copied from interface: Column
    
    Updates this column where values matching the selection are replaced with the corresponding value from the given column
    
    Specified by:
    
    set in interface Column<LocalDate>
  - first
```
public DateColumn first(int numRows)
```
    Specified by:
    
    first in interface Column<LocalDate>
  - last
```
public DateColumn last(int numRows)
```
    Specified by:
    
    last in interface Column<LocalDate>
  - inRange
```
public DateColumn inRange(int start,
                          int end)
```
    Description copied from interface: Column
    
    Returns a column containing the rows in this column beginning with start inclusive, and ending with end exclusive
    
    Specified by:
    
    inRange in interface Column<LocalDate>
  - sampleN
```
public DateColumn sampleN(int n)
```
    Description copied from interface: Column
    
    Returns a column containing a random sample of the values in this column
    
    Specified by:
    
    sampleN in interface Column<LocalDate>
    
    Parameters:
    
    n - the number of values to select
    
    Returns:
    
    A column of the same type as the receiver
  - sampleX
```
public DateColumn sampleX(double proportion)
```
    Description copied from interface: Column
    
    Returns a table consisting of randomly selected values from this column. The sample size is based on the given proportion of the total number of cells in this column
    
    Specified by:
    
    sampleX in interface Column<LocalDate>
    
    Parameters:
    
    proportion - The proportion to go in the sample

Class DateColumn

Field Summary

Fields inherited from class tech.tablesaw.columns.AbstractColumn

Method Summary

Methods inherited from class tech.tablesaw.columns.AbstractColumn

Methods inherited from class java.lang.Object

Methods inherited from interface tech.tablesaw.columns.dates.DateFilters

Methods inherited from interface tech.tablesaw.columns.dates.DateMapFunctions

Methods inherited from interface tech.tablesaw.api.CategoricalColumn

Methods inherited from interface tech.tablesaw.columns.Column

Methods inherited from interface java.lang.Iterable

Methods inherited from interface java.util.Comparator

Method Detail

create

create

create

create

size

subset

appendInternal

data

set

set

setPrintFormatter

setPrintFormatter

getString

getUnformattedString

emptyCopy

emptyCopy

copy

clear

lead

lag

sortAscending

sortDescending

countUnique

unique

append

append

set

max

min

set

appendMissing

get

isEmpty

rowComparator

append

appendObj

appendCell

appendCell

getIntInternal

getPackedDate

summary

valueIsMissing

countMissing

top

bottom

intIterator

removeMissing

asList

where

asSet

contains

setMissing

asDoubleArray

asDoubleColumn

isMissing

getDouble

byteSize

asBytes

iterator

fillWith

fillWith

fillWith

asObjectArray

compare

setName

filter

sorted