Class FilterCriteriaBuilder

Assembla i criteri di filtro utilizzando le impostazioni che aggiungi al generatore di criteri.

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

Indietro

FilterCriteria: una rappresentazione dei criteri di filtro.

Copia questi criteri di filtro e crea un generatore di criteri che puoi applicare a un altro filtro.

Puoi utilizzare questo metodo con qualsiasi tipo di filtro. Se utilizzi un filtro del foglio, puoi copiare i criteri in un'altra colonna.

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const 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);

Indietro

FilterCriteriaBuilder: un generatore di criteri di filtro basato su questi criteri.

Restituisce il tipo booleano dei criteri, ad esempio CELL_EMPTY. Per scoprire di più sui tipi di criteri booleani, consulta l'enumerazione BooleanCriteria.

Le persone spesso utilizzano questo metodo per aggiungere criteri di condizione booleana a un filtro senza sostituire i criteri esistenti.

• Per ottenere gli argomenti per i criteri, utilizza getCriteriaValues().
• Per utilizzare il tipo di criteri e i valori dei criteri per creare o modificare i criteri di filtro, consulta withCriteria(criteria, args).

Puoi utilizzare questo metodo per qualsiasi tipo di filtro. Se i criteri del filtro non sono una condizione booleana, restituisce null.

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

Indietro

BooleanCriteria|null: il tipo di criterio booleano o null se il criterio non è una condizione booleana.

Restituisce un array di argomenti per i criteri booleani. Alcuni tipi di criteri booleani non hanno argomenti e restituiscono un array vuoto, ad esempio CELL_NOT_EMPTY.

Le persone spesso utilizzano questo metodo per aggiungere criteri di condizione booleana a un filtro senza sostituire i criteri esistenti.

• Per ottenere il tipo di criterio booleano, utilizza getCriteriaType().
• Per utilizzare il tipo di criterio e i valori dei criteri per creare o modificare un criterio di filtro, consulta withCriteria(criteria, args).

  Puoi utilizzare questo metodo per qualsiasi tipo di filtro.

  const ss = SpreadsheetApp.getActiveSheet();
  const 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.
  const criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
  console.log(criteriaValues);

  Indietro

  Object[]: un array di argomenti appropriati per il tipo di criteri booleani. Il numero di argomenti e il relativo tipo corrispondono al metodo when...() corrispondente della classe FilterCriteriaBuilder.

Restituisce i valori nascosti dal filtro.

Utilizza questi criteri con i filtri nei fogli Grid, il tipo di foglio predefinito. Restituisce null se chiami questo metodo per altri tipi di filtri.

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

Indietro

String[]: un array di valori che il filtro nasconde.

Restituisce il colore di sfondo utilizzato come criterio di filtro. Le celle con questo colore di sfondo rimangono visibili.

Utilizza questi criteri con i filtri nei fogli Grid, il tipo di foglio predefinito. Restituisce null se chiami questo metodo per altri tipi di filtri.

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

Indietro

Color|null: il colore di sfondo utilizzato come criterio di filtro.

Restituisce il colore di primo piano utilizzato come criterio di filtro. Le celle con questo colore in primo piano rimangono visibili.

Utilizza questi criteri con i filtri nei fogli Grid, il tipo di foglio predefinito. Restituisce null se chiami questo metodo per altri tipi di filtri.

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

Indietro

Color|null: il colore di primo piano utilizzato come criterio di filtro.

Restituisce i valori mostrati dal filtro della tabella pivot.

Questi criteri sono validi solo per i filtri delle tabelle pivot non collegate a un database. Restituisce un array vuoto per altri tipi di filtri.

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

Indietro

String[]: un array di valori mostrati dal filtro della tabella pivot.

Imposta i valori da nascondere. Cancella tutti i valori visibili o nascosti esistenti.

Puoi utilizzare questo criterio solo per i filtri nei fogli Grid, il tipo di foglio predefinito.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Genera

Error: se uno qualsiasi dei valori è null.

Imposta il colore di sfondo utilizzato come criterio di filtro. Le celle con questo colore di sfondo rimangono visibili. L'impostazione di un criterio di filtro per il colore di sfondo rimuove tutti i criteri di filtro per il colore correnti da questo generatore.

Puoi utilizzare questo criterio solo per i filtri nei fogli Grid, il tipo di foglio predefinito.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta il colore di primo piano utilizzato come criterio di filtro. Le celle con questo colore in primo piano rimangono visibili. L'impostazione di un criterio di filtro per il colore di primo piano rimuove tutti i criteri di filtro per il colore correnti da questo builder.

Puoi utilizzare questo criterio solo per i filtri nei fogli Grid, il tipo di foglio predefinito.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i valori da mostrare in una tabella pivot. Cancella tutti i valori visibili o nascosti esistenti.

Puoi utilizzare questo criterio solo per i filtri nelle tabelle pivot non connesse a un database.

// 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."
const pivotTable = ss.getPivotTables()[0];
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setVisibleValues(['Northeast', 'Southwest'])
                     .build();
pivotTable.addFilter(2, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Genera

Error: se uno qualsiasi dei valori è null.

Imposta i criteri di filtro per mostrare le celle vuote.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle non vuote.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date successive a quella specificata.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date successive alla data relativa specificata. Per visualizzare le opzioni relative alla data, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date precedenti alla data specificata.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date precedenti alla data relativa specificata. Per visualizzare le opzioni relative alla data, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date uguali alla data specificata.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro che mostrano le celle con date uguali alla data relativa specificata. Per visualizzare le opzioni relative alla data, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale filtri non deve essere una data, ma se non lo è, potresti ottenere risultati imprevisti.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle con date uguali a una qualsiasi delle date specificate.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle che non sono uguali alla data specificata.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

Il tipo di dati della colonna in base alla quale filtri deve essere una data.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con date diverse da quelle specificate.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle con una formula specificata (ad esempio =B:B<C:C) che restituisce true.

Puoi utilizzare questo criterio solo per filtrare i dati non collegati a un database.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const 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.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero compreso tra due numeri specificati o uguale a uno di questi.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero uguale a quello specificato.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle con un numero uguale a uno qualsiasi dei numeri specificati.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero maggiore di quello specificato

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle con un numero maggiore o uguale al numero specificato.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero inferiore a quello specificato.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero inferiore o uguale al numero specificato.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero che non rientra tra due numeri specificati e non corrisponde a nessuno dei due.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero diverso da quello specificato.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale filtri deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma se non lo è, potresti ottenere risultati imprevisti.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con un numero diverso da quelli specificati.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo che contiene il testo specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo che non contiene il testo specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo che termina con il testo specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo uguale a quello specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo uguale a uno qualsiasi dei valori di testo specificati. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo diverso da quello specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro in modo da mostrare le celle con testo diverso da uno qualsiasi dei valori specificati. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questo criterio solo con i dati collegati a un database. Ad esempio, utilizza questo criterio con i filtri in un foglio DataSource, un foglio collegato a un database o un DataSourcePivotTable, una tabella pivot creata da un foglio DataSource.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro per mostrare le celle con testo che inizia con il testo specificato. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

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

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.

Imposta i criteri di filtro su una condizione booleana definita dai valori BooleanCriteria, ad esempio CELL_EMPTY o NUMBER_GREATER_THAN. Per copiare la condizione booleana dai criteri esistenti, definisci i parametri per questo metodo utilizzando getCriteriaType() e getCriteriaValues() in un criterio esistente.

Puoi utilizzare questo criterio con qualsiasi tipo di filtro, ma alcuni BooleanCriteria non sono applicabili a tutti i filtri.

// 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();
const 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."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Parametri

Indietro

FilterCriteriaBuilder: questo generatore, per il concatenamento.