Class FilterCriteriaBuilder

Ensambla los criterios de filtro con la configuración que agregas al creador de criterios.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria() // Creates a criteria builder.
                             .whenCellNotEmpty() // Adds settings to the builder.
                             .build();          // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

Devolvedor

FilterCriteria: Es una representación de los criterios de filtro.

Copia estos criterios de filtro y crea un compilador de criterios que puedes aplicar a otro filtro.

Puedes usar este método con cualquier tipo de filtro. Si usas un filtro de hoja, puedes copiar los criterios en otra columna.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
let criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any existing
// criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

Devolvedor

FilterCriteriaBuilder: Es un creador de criterios de filtro basado en estos criterios de filtro.

Muestra el tipo booleano de los criterios, por ejemplo, CELL_EMPTY. Para obtener información sobre los tipos de criterios booleanos, consulta la enumeración BooleanCriteria.

A menudo, las personas usan este método para agregar criterios de condición booleanos a un filtro sin reemplazar los criterios existentes.

• Para obtener los argumentos de los criterios, usa getCriteriaValues().
• Si quieres usar el tipo de criterio y los valores de criterio para crear o modificar los criterios de filtro, consulta withCriteria(criteria, args).

Puedes usar este método para cualquier tipo de filtro. Si los criterios de filtro no son una condición booleana, muestra null.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
let filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type object.
let criteriaType = filter.getColumnFilterCriteria(2)
                         .getCriteriaType()
                         .toString();
// Logs the criteria type.
console.log(criteriaType);

Devolvedor

BooleanCriteria: Es el tipo de criterios booleanos, o null si los criterios no son una condición booleana.

Muestra un array de argumentos para criterios booleanos. Algunos tipos de criterios booleanos no tienen argumentos y muestran un array vacío, por ejemplo, CELL_NOT_EMPTY.

A menudo, las personas usan este método para agregar criterios de condición booleanos a un filtro sin reemplazar los criterios existentes.

• Para obtener el tipo de criterios booleanos, usa getCriteriaType().
• Si quieres usar el tipo de criterio y los valores de criterio para crear o modificar un criterio de filtro, consulta withCriteria(criteria, args).

  Puedes usar este método para cualquier tipo de filtro.

  let ss = SpreadsheetApp.getActiveSheet();
  let filter = ss.getFilter();
  // Gets the values of the boolean criteria and logs them. For example, if the boolean
  // condition is whenNumberGreaterThan(10), then the logged value is 10.
  let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
  console.log(criteriaValues);

  Devolvedor

  Object[]: Es un array de argumentos apropiados para el tipo de criterios booleanos. La cantidad de argumentos y su tipo coinciden con el método when...() correspondiente de la clase FilterCriteriaBuilder.

Muestra los valores que oculta el filtro.

Usa este criterio con filtros en Grid hojas, el tipo predeterminado de hoja. Muestra null si llamas a este método para otros tipos de filtros.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

Devolvedor

String[]: Es un array de valores que oculta el filtro.

Muestra el color de fondo usado como criterios de filtro. Las celdas con este color de fondo permanecen visibles.

Usa este criterio con filtros en Grid hojas, el tipo predeterminado de hoja. Muestra null si llamas a este método para otros tipos de filtros.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the background color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Devolvedor

Color: Es el color de fondo que se usa como criterios de filtro.

Muestra el color de primer plano que se usa como criterio de filtro. Las celdas con este color de primer plano permanecen visibles.

Usa este criterio con filtros en Grid hojas, el tipo predeterminado de hoja. Muestra null si llamas a este método para otros tipos de filtros.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Logs the foreground color that column B is filtered by as a hexadecimal string.
let filter = range.getFilter();
let color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

Devolvedor

Color: Es el color de primer plano que se usa como criterio de filtro.

Muestra los valores que muestra el filtro de tabla dinámica.

Este criterio es solo para los filtros de las tablas dinámicas que no están conectadas a una base de datos. Muestra un array vacío para otros tipos de filtros.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

Devolvedor

String[]: Es un array de valores que muestra el filtro de tabla dinámica.

Establece los valores que se ocultarán. Borra cualquier valor oculto o visible existente.

Solo puedes usar estos criterios para los filtros en hojas Grid, el tipo predeterminado de hoja.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["Hello", "World"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece el color de fondo que se usa como criterios de filtro. Las celdas con este color de fondo permanecen visibles. Cuando se establecen criterios de filtro de color de fondo, se quitan los criterios actuales de filtro de color de este compilador.

Solo puedes usar estos criterios para los filtros en hojas Grid, el tipo predeterminado de hoja.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleBackgroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece el color de primer plano que se usa como criterios de filtro. Las celdas con este color de primer plano permanecen visibles. Cuando se establecen criterios de filtro de color de primer plano, se quitan los criterios actuales de filtro de color de este compilador.

Solo puedes usar estos criterios para los filtros en hojas Grid, el tipo predeterminado de hoja.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleForegroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los valores que se mostrarán en una tabla dinámica. Borra cualquier valor oculto o visible existente.

Solo puedes utilizar este criterio para los filtros de las tablas dinámicas que no están conectadas a una base de datos.

// Gets the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet and adds a filter to it that
// sets the visible values to "Northeast" and "Southwest."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas vacías.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellEmpty()
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas que no están vacías.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellNotEmpty()
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro que muestran celdas con fechas posteriores a la fecha especificada.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro que muestran celdas con fechas posteriores a la fecha relativa especificada. Para ver las opciones de fecha relativas, consulta Enum RelativeDate.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece criterios de filtro que muestran celdas con fechas anteriores a la fecha especificada.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece criterios de filtro que muestran celdas con fechas anteriores a la fecha relativa especificada. Para ver las opciones de fechas relativas, consulta Enum RelativeDate.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro que muestran celdas con fechas que son iguales a la fecha especificada.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro que muestran celdas con fechas que son iguales a la fecha relativa especificada. Para ver las opciones de fechas relativas, consulta Enum RelativeDate.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser una fecha. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser una fecha, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past month
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.PAST_MONTH;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas con fechas iguales a cualquiera de las fechas especificadas.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below dates.
let date1 = new Date("June 1, 2022");
let date2 = new Date("June 2, 2022");
let date3 = new Date("June 3, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualToAny([date1, date2, date3])
                             .build();
dataSheet.addFilter("date", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas que no son iguales a la fecha especificada.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

El tipo de datos de la columna por la que filtras debe ser una fecha.

// Gets a pivot table that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Pivot Table Sheet");
let dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
let date = new Date("June 16, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateNotEqualTo(date)
                             .build();
dataPivotTable.addFilter("date", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas con fechas que no son iguales a ninguna de las fechas especificadas.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below dates.
let date1 = new Date("June 1, 2022");
let date2 = new Date("June 2, 2022");
let date3 = new Date("June 3, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateNotEqualToAny([date1, date2, date3])
                             .build();
dataSheet.addFilter("date", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro para mostrar las celdas con una fórmula especificada (como =B:B<C:C) que se evalúa como true.

Solo puedes usar estos criterios para filtrar datos que no estén conectados a una base de datos.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows the rows where the value in column B is less than the value in
// column C and sets it to column A.
let formula = "=B:B<C:C";
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenFormulaSatisfied(formula)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con un número que se encuentra entre 2 números especificados o que es cualquiera de ellos.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25, inclusively,
// and sets it to column A.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar celdas con un número igual al número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar celdas con un número igual a cualquiera de los números especificados.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con un número superior al número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar celdas con un número mayor o igual que el número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar las celdas con un número menor que el número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar las celdas con un número menor o igual que el número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con un número que no se encuentra en el medio y que no es ninguno de los dos números especificados.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25, inclusively,
// and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar las celdas con un número que no es igual al número especificado.

Puedes utilizar este criterio con cualquier tipo de filtro. Si usas este criterio con datos que están conectados a una base de datos, el tipo de datos de la columna por la que estás filtrando debe ser un número. Si los datos no están conectados a una base de datos, el tipo de datos de la columna que estás filtrando no necesita ser un número, pero si no lo es, es posible que obtengas resultados inesperados.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar las celdas con un número que no es igual a ninguno de los números especificados.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20, or 30.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualToAny([10,20,30])
                             .build();
dataSheet.addFilter("amount", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con texto que contiene el texto especificado. El texto no distingue mayúsculas de minúsculas.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextContains("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con texto que no contiene el texto especificado. El texto no distingue mayúsculas de minúsculas.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextDoesNotContain("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar las celdas con texto que termina con el texto especificado. El texto no distingue mayúsculas de minúsculas.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEndsWith("est")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas con texto igual al texto especificado. El texto no distingue mayúsculas de minúsculas.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualTo("hello")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar celdas con texto igual a cualquiera de los valores de texto especificados. El texto no distingue mayúsculas de minúsculas.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas con texto que no es igual al texto especificado. El texto no distingue mayúsculas de minúsculas.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to "tech."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualTo("tech")
                             .build();
dataSheet.addFilter("category", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Configura los criterios del filtro para mostrar celdas con texto que no es igual a ninguno de los valores especificados. El texto no distingue mayúsculas de minúsculas.

Solo puedes usar estos criterios con datos conectados a una base de datos. Por ejemplo, usa estos criterios con filtros en una hoja DataSource, una hoja que esté conectada a una base de datos, o un DataSourcePivotTable, una tabla dinámica creada a partir de una hoja DataSource.

// Gets the sheet that's connected to a database.
let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet");
let dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios del filtro para mostrar celdas con texto que comienza con el texto especificado. El texto no distingue mayúsculas de minúsculas.

Puedes utilizar este criterio con cualquier tipo de filtro.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextStartsWith("pre")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.

Establece los criterios de filtro en una condición booleana definida por valores de BooleanCriteria, como CELL_EMPTY o NUMBER_GREATER_THAN. Para copiar la condición booleana de los criterios existentes, define los parámetros de este método con getCriteriaType() y getCriteriaValues() en un criterio existente.

Puedes usar estos criterios con cualquier tipo de filtro, pero algunos BooleanCriteria no se aplican a todos los filtros.

// Builds a filter criteria that is based on existing boolean conditions from another criteria.
// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to column C that
// has the same boolean conditions and additional criteria that hides the value, "Northwest."
let filter = ss.getFilter();
let filterCriteria = filter.getColumnFilterCriteria(2);
let criteria = SpreadsheetApp.newFilterCriteria()
    .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues())
    .setHiddenValues(["Northwest"])
    .build();
filter.setColumnFilterCriteria(3, criteria);

Parámetros

Devolvedor

FilterCriteriaBuilder: Este compilador se usa para encadenar.