Class DataTableBuilder

DataTableBuilder

Compilador de objetos DataTable. Para crear una tabla de datos, primero debes especificar sus columnas y, luego, agregar sus filas, una a la vez. Ejemplo:

var data = Charts.newDataTable()
    .addColumn(Charts.ColumnType.STRING, "Month")
    .addColumn(Charts.ColumnType.NUMBER, "In Store")
    .addColumn(Charts.ColumnType.NUMBER, "Online")
    .addRow(["January", 10, 1])
    .addRow(["February", 12, 1])
    .addRow(["March", 20, 2])
    .addRow(["April", 25, 3])
    .addRow(["May", 30, 4])
    .build();

Métodos

MétodoTipo de datos que se muestraDescripción breve
addColumn(type, label)DataTableBuilderAgrega una columna a la tabla de datos.
addRow(values)DataTableBuilderAgrega una fila a la tabla de datos.
build()DataTableCompila y muestra una tabla de datos.
setValue(row, column, value)DataTableBuilderEstablece un valor específico en la tabla.

Documentación detallada

addColumn(type, label)

Agrega una columna a la tabla de datos. Se agregarán columnas de 0 a n.

Los gráficos de etiquetas suelen usar la primera columna (por ejemplo, etiquetas del eje X en gráficos de líneas o etiquetas de porción en gráficos circulares). Las otras columnas se usan a menudo para datos y, por lo tanto, a menudo requieren valores numéricos.

Parámetros

NombreTipoDescripción
typeColumnTypetipo de datos en la columna (número, cadena o fecha)
labelStringetiqueta de la columna (se usa para leyendas de gráficos).

Devolvedor

DataTableBuilder: Este compilador se usa para encadenar.


addRow(values)

Agrega una fila a la tabla de datos.

Parámetros

NombreTipoDescripción
valuesObject[]valores para la fila, especificados en el mismo orden en que se ingresan las columnas.

Devolvedor

DataTableBuilder: Este compilador se usa para encadenar.


build()

Compila y muestra una tabla de datos.

Devolvedor

DataTable: Es la tabla de datos.

Arroja

Error: Si la tabla de datos está vacía o tiene errores de formato


setValue(row, column, value)

Establece un valor específico en la tabla.

Puedes establecer un valor antes de agregar la columna a la tabla de datos. Sin embargo, a menos que la columna se agregue en algún momento, se ignorará el valor.

No es necesario completar todos los valores de las columnas. Los que falten se considerarán null.

Parámetros

NombreTipoDescripción
rowIntegerel índice de la fila (la primera fila tiene el índice 0)
columnIntegerel índice de la columna (la primera columna tiene un índice 0)
valueObjectel valor de la celda de la tabla (debe tener el tipo correcto para la columna).

Devolvedor

DataTableBuilder: Este compilador se usa para encadenar.