Questa pagina è stata tradotta dall'API Cloud Translation.

Class FilterCriteriaBuilder

Per aggiungere criteri a un filtro:

Crea il generatore di criteri utilizzando SpreadsheetApp.newFilterCriteria().
Aggiungi le impostazioni allo strumento per la creazione utilizzando i metodi di questo corso.
Usa build() per assemblare i criteri con le impostazioni specificate.

Utilizzi comuni

Nascondere i valori in un foglio

L'esempio seguente ottiene un filtro esistente di un foglio e aggiunge criteri che nascondono le celle nella colonna C che contengono "ciao" o "mondo". I criteri in questo esempio possono essere utilizzati solo con i filtri su Grid fogli, il tipo predefinito di foglio.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Mostra solo celle non vuote

Nel seguente esempio viene aggiunto un filtro a un foglio DataSource, un foglio collegato a un database, con criteri che mostrano solo le celle della colonna "Categoria" che non sono vuote.

// Gets the sheet named "Connected sheet," which is connected to a database.
let sheet = SpreadsheetApp.getActiveSpreadsheet()
                          .getSheetByName("Connected sheet")
                          .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellNotEmpty()
                             .build();
// Applies the criteria to the column named "Category."
sheet.addFilter("Category", criteria);

Metodi

Metodo	Tipo restituito	Breve descrizione
`build()`	`FilterCriteria`	Assembla i criteri di filtro utilizzando le impostazioni aggiunte al generatore di criteri.
`copy()`	`FilterCriteriaBuilder`	Copia questo criterio di filtro e crea un generatore di criteri che puoi applicare a un altro filtro.
`getCriteriaType()`	`BooleanCriteria`	Restituisce il tipo booleano del criterio, ad esempio `CELL_EMPTY`.
`getCriteriaValues()`	`Object[]`	Restituisce un array di argomenti per criteri booleani.
`getHiddenValues()`	`String[]`	Restituisce i valori che il filtro nasconde.
`getVisibleBackgroundColor()`	`Color`	Restituisce il colore di sfondo utilizzato come criterio di filtro.
`getVisibleForegroundColor()`	`Color`	Restituisce il colore di primo piano utilizzato come criterio di filtro.
`getVisibleValues()`	`String[]`	Restituisce i valori mostrati dal filtro della tabella pivot.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	Imposta i valori da nascondere.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	Imposta il colore di sfondo utilizzato come criteri di filtro.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	Imposta il colore di primo piano utilizzato come criterio di filtro.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	Imposta i valori da visualizzare in una tabella pivot.
`whenCellEmpty()`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da visualizzare le celle vuote.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da visualizzare le celle che non sono vuote.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro che mostrano le celle con date successive alla data specificata.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro che mostrano le celle con date successive alla data relativa specificata.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro che mostrano le celle con date precedenti alla data specificata.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro che mostrano le celle con date precedenti alla data relativa specificata.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Imposta criteri di filtro che mostrano le celle con date corrispondenti alla data specificata.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro che mostrano le celle con date corrispondenti alla data relativa specificata.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per visualizzare le celle con date corrispondenti a una qualsiasi delle date specificate.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da visualizzare le celle che non sono uguali alla data specificata.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con date diverse da una delle date specificate.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con una formula specificata (ad esempio `=B:B<C:C`) che restituisce come `true`.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero che rientra o è uno di 2 numeri specificati.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero uguale al numero specificato.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero uguale a uno qualsiasi dei numeri specificati.
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da mostrare le celle con un numero maggiore di quello specificato
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero maggiore o uguale al numero specificato.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero inferiore al numero specificato.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero minore o uguale al numero specificato.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da mostrare le celle con un numero che non rientra tra e non è né uno dei due numeri specificati.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero diverso dal numero specificato.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con un numero diverso da nessuno dei numeri specificati.
`whenTextContains(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con testo contenente il testo specificato.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da mostrare le celle con testo che non contiene il testo specificato.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da mostrare le celle con testo che termina con il testo specificato.
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con testo uguale al testo specificato.
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con testo uguale a uno qualsiasi dei valori di testo specificati.
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con testo diverso dal testo specificato.
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro per mostrare le celle con testo diverso da nessuno dei valori specificati.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro in modo da mostrare le celle con un testo che inizia con il testo specificato.
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	Imposta i criteri di filtro su una condizione booleana definita dai valori `BooleanCriteria`, ad esempio `CELL_EMPTY` o `NUMBER_GREATER_THAN`.

Documentazione dettagliata

`build()`

Assembla i criteri di filtro utilizzando le impostazioni aggiunte al generatore di criteri.

// 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);

Ritorni

FilterCriteria: rappresentazione dei criteri di filtro.

`copy()`

Copia questo criterio 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 usi un filtro del foglio, puoi copiare i criteri in un'altra colonna.

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);

Ritorni

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

`getCriteriaType()`

Restituisce il tipo booleano del criterio, ad esempio CELL_EMPTY. Per scoprire i tipi di criteri booleani, vedi l'enumerazione BooleanCriteria.

Spesso questo metodo viene utilizzato per aggiungere criteri di condizione booleana a un filtro senza sostituire i criteri esistenti.

Per ottenere gli argomenti dei 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 di filtro non è una condizione booleana, restituisce 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);

Ritorni

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

`getCriteriaValues()`

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

Spesso questo metodo viene utilizzato per aggiungere criteri di condizione booleana a un filtro senza sostituire i criteri esistenti.

Per ottenere il tipo di criteri booleano, utilizza getCriteriaType().
Per utilizzare il tipo di criteri 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.
```
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);
```
Ritorni

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

`getHiddenValues()`

Restituisce i valori che il filtro nasconde.

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

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);

Ritorni

String[]: array di valori nascosti dal filtro.

`getVisibleBackgroundColor()`

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

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

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);

Ritorni

Color: il colore dello sfondo utilizzato come criterio di filtro.

`getVisibleForegroundColor()`

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

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

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);

Ritorni

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

`getVisibleValues()`

Restituisce i valori mostrati dal filtro della tabella pivot.

Questo criterio è valido solo per i filtri sulle tabelle pivot che non sono connesse a un database. Restituisce un array vuoto per altri tipi di filtri.

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);

Ritorni

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

`setHiddenValues(values)`

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

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

// 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);

Parametri

Nome	Tipo	Descrizione
`values`	`String[]`	L'elenco di valori da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`setVisibleBackgroundColor(visibleBackgroundColor)`

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

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

// 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);

Parametri

Nome	Tipo	Descrizione
`visibleBackgroundColor`	`Color`	Il colore di sfondo da impostare. Il colore deve essere di tipo RGB. Questo metodo non supporta i colori del tema.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`setVisibleForegroundColor(visibleForegroundColor)`

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 colore in primo piano rimuove tutti i criteri attuali di filtro colore da questo generatore.

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

// 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);

Parametri

Nome	Tipo	Descrizione
`visibleForegroundColor`	`Color`	Il colore di primo piano da impostare. Il colore deve essere di tipo RGB. Questo metodo non supporta i colori del tema.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`setVisibleValues(values)`

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

Puoi utilizzare questo criterio solo per i filtri sulle tabelle pivot che non sono 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."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

Parametri

Nome	Tipo	Descrizione
`values`	`String[]`	L'elenco di valori da visualizzare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenCellEmpty()`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenCellNotEmpty()`

Imposta i criteri di filtro in modo da visualizzare le celle che non sono vuote.

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateAfter(date)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere una data. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere una data; in caso contrario, potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	L'ultima data da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateAfter(date)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	L'ultima data relativa.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateBefore(date)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La prima data da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateBefore(date)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	La prima data relativa da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateEqualTo(date)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La data in cui devono corrispondere i valori delle celle.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateEqualTo(date)`

Imposta i criteri di filtro che mostrano le celle con date corrispondenti alla data relativa specificata. Per visualizzare le opzioni di date relative, fai riferimento a Enum RelativeDate.

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	La data relativa a cui devono corrispondere i valori delle celle.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateEqualToAny(dates)`

Imposta i criteri di filtro per visualizzare le celle con date corrispondenti a una qualsiasi delle date specificate.

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criterio con i filtri su un foglio DataSource, un foglio collegato a un database o una DataSourcePivotTable, una tabella pivot creata da un foglio 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);

Parametri

Nome	Tipo	Descrizione
`dates`	`Date[]`	Le date da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateNotEqualTo(date)`

Imposta i criteri di filtro in modo da visualizzare le celle che non sono uguali alla data specificata.

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

// 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);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La data da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenDateNotEqualToAny(dates)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`dates`	`Date[]`	Le date da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenFormulaSatisfied(formula)`

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

Puoi utilizzare questo criterio solo per filtrare i dati che non sono connessi a un database.

// 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);

Parametri

Nome	Tipo	Descrizione
`formula`	`String`	Una formula personalizzata che restituisce `true` se l'input è valido.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberBetween(start, end)`

Imposta i criteri di filtro per mostrare le celle con un numero che rientra o è uno di 2 numeri specificati.

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il numero più basso da mostrare.
`end`	`Number`	Il numero più alto da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberEqualTo(number)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberEqualToAny(numbers)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`numbers`	`Number[]`	I numeri da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberGreaterThan(number)`

Imposta i criteri di filtro in modo da mostrare le celle con un numero maggiore di quello specificato

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero più alto da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberGreaterThanOrEqualTo(number)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero più basso da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberLessThan(number)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero più basso da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberLessThanOrEqualTo(number)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero più alto da mostrare.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberNotBetween(start, end)`

Imposta i criteri di filtro in modo da mostrare le celle con un numero che non rientra tra e non è né uno dei due numeri specificati.

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il numero più basso nascosto.
`end`	`Number`	Il numero più alto da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberNotEqualTo(number)`

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

Puoi utilizzare questo criterio 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 stai filtrando deve essere un numero. Se i dati non sono connessi a un database, il tipo di dati della colonna in base alla quale stai filtrando non deve essere un numero, ma in caso contrario potresti ottenere risultati imprevisti.

// 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);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il numero da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenNumberNotEqualToAny(numbers)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`numbers`	`Number[]`	I numeri da nascondere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextContains(text)`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il testo che la cella deve contenere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextDoesNotContain(text)`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il testo che la cella non deve contenere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextEndsWith(text)`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Testo che deve essere contenuto alla fine del testo della cella.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextEqualTo(text)`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il testo a cui deve essere uguale il testo della cella.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextEqualToAny(texts)`

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.

// 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);

Parametri

Nome	Tipo	Descrizione
`texts`	`String[]`	I valori di testo che una cella deve coincidere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextNotEqualTo(text)`

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

// 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il testo con cui il testo della cella non può essere uguale.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextNotEqualToAny(texts)`

Imposta i criteri di filtro per mostrare le celle con testo diverso da nessuno dei valori specificati. Il testo non è sensibile alle maiuscole.

// 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);

Parametri

Nome	Tipo	Descrizione
`texts`	`String[]`	Valori di testo che una cella non può coincidere.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`whenTextStartsWith(text)`

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

Puoi utilizzare questo criterio con qualsiasi tipo di 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);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Testo che deve contenere l'inizio della cella.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.

`withCriteria(criteria, args)`

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() su 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();
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);

Parametri

Nome	Tipo	Descrizione
`criteria`	`BooleanCriteria`	Il tipo di criterio booleano.
`args`	`Object[]`	Un array di argomenti appropriato per il tipo di criteri; il numero di argomenti e il relativo tipo corrispondono ai metodi `when...()` corrispondenti precedenti.

Ritorni

FilterCriteriaBuilder - Questo builder, per il concatenamento.