Generatore per i criteri di filtro. Per aggiungere criteri a un filtro, devi procedere nel seguente modo:
- Crea il generatore di criteri utilizzando
Spreadsheet
.App.newFilterCriteria() - Aggiungi le impostazioni al generatore utilizzando i metodi di questa classe.
- Utilizza
build()
per assemblare i criteri con le impostazioni specificate.
Utilizzi comuni
Nascondere i valori in un foglio
Il seguente esempio recupera il filtro esistente di un foglio e aggiunge criteri che nascondono le celle della colonna C contenenti "hello" o "world". I criteri in questo esempio possono essere utilizzati solo con i filtri dei fogliGrid
, il tipo di foglio predefinito.
const ss = SpreadsheetApp.getActiveSheet(); const filter = ss.getFilter(); const criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(['hello', 'world']) .build(); filter.setColumnFilterCriteria(3, criteria);
Mostra solo le celle non vuote
Il seguente esempio aggiunge un filtro a un foglioData Source
, 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. const sheet = SpreadsheetApp.getActiveSpreadsheet() .getSheetByName('Connected sheet') .asDataSourceSheet(); // Creates criteria that only shows non-empty cells. const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build(); // Applies the criteria to the column named "Category." sheet.addFilter('Category', criteria);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | Filter | Consente di assemblare i criteri di filtro utilizzando le impostazioni aggiunte al generatore di criteri. |
copy() | Filter | Copia questi criteri di filtro e crea un generatore di criteri che puoi applicare a un altro filtro. |
get | Boolean | Restituisce il tipo booleano dei criteri, ad esempio CELL_EMPTY . |
get | Object[] | Restituisce un array di argomenti per i criteri booleani. |
get | String[] | Restituisce i valori nascosti dal filtro. |
get | Color | Restituisce il colore di sfondo utilizzato come criterio di filtro. |
get | Color | Restituisce il colore di primo piano utilizzato come criterio di filtro. |
get | String[] | Restituisce i valori visualizzati dal filtro della tabella pivot. |
set | Filter | Imposta i valori da nascondere. |
set | Filter | Imposta il colore di sfondo utilizzato come criterio di filtro. |
set | Filter | Imposta il colore di primo piano utilizzato come criterio di filtro. |
set | Filter | Imposta i valori da mostrare in una tabella pivot. |
when | Filter | Imposta i criteri di filtro in modo da mostrare le celle vuote. |
when | Filter | Imposta i criteri di filtro per mostrare le celle non vuote. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date successive alla data specificata. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date successive alla data relativa specificata. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date precedenti alla data specificata. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date precedenti alla data relativa specificata. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date uguali alla data specificata. |
when | Filter | Imposta i criteri di filtro che mostrano le celle con date uguali alla data relativa specificata. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con date uguali a una delle date specificate. |
when | Filter | Imposta i criteri di filtro per mostrare le celle che non corrispondono alla data specificata. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con date diverse da quelle specificate. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con una formula specificata (ad es. =B:B<C:C ) che dà un valore di true . |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero compreso tra due numeri specificati o che corrisponde a uno di questi. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero uguale a quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero uguale a uno dei numeri specificati. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero maggiore di quello specificato |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero maggiore o uguale a quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero inferiore a quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero minore o uguale a quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero non compreso tra due numeri specificati e che non è nessuno dei due. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero diverso da quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con un numero diverso da uno dei numeri specificati. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo contenente il testo specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo che non contiene il testo specificato. |
when | Filter | Imposta i criteri di filtro in modo da mostrare le celle con il testo che termina con il testo specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo uguale a quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo uguale a uno qualsiasi dei valori di testo specificati. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo diverso da quello specificato. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo diverso da uno dei valori specificati. |
when | Filter | Imposta i criteri di filtro per mostrare le celle con testo che inizia con il testo specificato. |
with | Filter | Imposta i criteri di filtro su una condizione booleana definita dai valori Boolean , ad esempio CELL_EMPTY o NUMBER_GREATER_THAN . |
Documentazione dettagliata
build()
Consente di assemblare i criteri di filtro utilizzando le impostazioni aggiunte 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);
Invio
Filter
: una rappresentazione dei criteri di filtro.
copy()
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);
Invio
Filter
: un generatore di criteri di filtro basato su questi criteri di filtro.
get Criteria Type()
Restituisce il tipo booleano dei criteri, ad esempio CELL_EMPTY
. Per scoprire i tipi di criteri booleani, consulta l'enum Boolean
.
Questo metodo viene spesso utilizzato per aggiungere criteri di condizione booleana a un filtro senza sostituire quelli esistenti.
- Per ottenere gli argomenti per i criteri, utilizza
get
.Criteria Values() - Per utilizzare il tipo di criteri e i valori dei criteri per creare o modificare i criteri di filtro, consulta
with
.Criteria(criteria, args)
Puoi utilizzare questo metodo per qualsiasi tipo di filtro. Se i criteri di 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);
Invio
Boolean
: il tipo di criteri booleani o null
se i criteri non sono una condizione booleana.
get Criteria Values()
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
.
Questo metodo viene spesso utilizzato per aggiungere criteri di condizione booleana a un filtro senza sostituire quelli esistenti.
- Per ottenere il tipo di criteri booleani, utilizza
get
.Criteria Type() - Per utilizzare il tipo di criteri e i valori dei criteri per creare o modificare i criteri di un filtro, consulta
with
.Criteria(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);
Invio
Object[]
: un array di argomenti appropriati al tipo di criteri booleani. Il numero di argomenti e il relativo tipo corrispondono al metodowhen...()
corrispondente della classeFilter
.Criteria Builder
get Hidden Values()
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);
Invio
String[]
: un array di valori nascosti dal filtro.
get Visible Background Color()
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);
Invio
Color
: il colore di sfondo utilizzato come criterio di filtro.
get Visible Foreground Color()
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);
Invio
Color
: il colore di primo piano utilizzato come criterio di filtro.
get Visible Values()
Restituisce i valori visualizzati dal filtro della tabella pivot.
Questi criteri si applicano solo ai 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);
Invio
String[]
: un array di valori visualizzati dal filtro della tabella pivot.
set Hidden Values(values)
Imposta i valori da nascondere. Cancella eventuali valori visibili o nascosti esistenti.
Puoi utilizzare questi criteri solo per i filtri dei 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
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | L'elenco dei valori da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
Lanci
Error
: se uno dei valori è null
.
set Visible Background Color(visibleBackgroundColor)
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 del colore di sfondo rimuove eventuali criteri di filtro del colore correnti da questo generatore.
Puoi utilizzare questi criteri solo per i filtri dei 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
Nome | Tipo | Descrizione |
---|---|---|
visible | Color | Il colore di sfondo da impostare. Il colore deve essere di stile RGB. Questo metodo non supporta i colori del tema. |
Invio
Filter
: questo generatore, per l'accodamento.
set Visible Foreground Color(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 del colore di primo piano rimuove tutti i criteri di filtro del colore correnti da questo generatore.
Puoi utilizzare questi criteri solo per i filtri dei 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
Nome | Tipo | Descrizione |
---|---|---|
visible | Color | Il colore di primo piano da impostare. Il colore deve essere di stile RGB. Questo metodo non supporta i colori del tema. |
Invio
Filter
: questo generatore, per l'accodamento.
set Visible Values(values)
Imposta i valori da mostrare in una tabella pivot. Cancella eventuali valori visibili o nascosti esistenti.
Puoi utilizzare questi criteri solo per i filtri delle tabelle pivot non collegate 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
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | L'elenco dei valori da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
Lanci
Error
: se uno dei valori è null
.
when Cell Empty()
Imposta i criteri di filtro in modo da 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);
Invio
Filter
: questo generatore, per l'accodamento.
when Cell Not Empty()
Imposta i criteri di filtro per 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);
Invio
Filter
: questo generatore, per l'accodamento.
when Date After(date)
Imposta i criteri di filtro che mostrano le celle con date successive alla data specificata.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data più recente da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date After(date)
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 Relative
.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data relativa più recente. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Before(date)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data più antica da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Before(date)
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 Relative
.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data relativa più antica da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Equal To(date)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data a cui devono corrispondere i valori delle celle. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Equal To(date)
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 Relative
.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale esegui il filtro deve essere una data. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro non deve essere una data, ma in caso contrario 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
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data relativa a cui devono corrispondere i valori delle celle. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Equal To Any(dates)
Imposta i criteri di filtro per mostrare le celle con date uguali a una delle date specificate.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
dates | Date[] | Le date da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Not Equal To(date)
Imposta i criteri di filtro per mostrare le celle che non corrispondono alla data specificata.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
Il tipo di dati della colonna in base alla quale esegui il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Date Not Equal To Any(dates)
Imposta i criteri di filtro per mostrare le celle con date diverse da quelle specificate.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
dates | Date[] | Le date da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Formula Satisfied(formula)
Imposta i criteri di filtro per mostrare le celle con una formula specificata (ad es. =B:B<C:C
) che dà un valore di true
.
Puoi utilizzare questi criteri 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
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula personalizzata che restituisce true se l'input è valido. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Between(start, end)
Imposta i criteri di filtro per mostrare le celle con un numero compreso tra due numeri specificati o che corrisponde a uno di questi.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il numero più basso da mostrare. |
end | Number | Il numero più alto da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Equal To(number)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Equal To Any(numbers)
Imposta i criteri di filtro per mostrare le celle con un numero uguale a uno dei numeri specificati.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
numbers | Number[] | I numeri da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Greater Than(number)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero più alto da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Greater Than Or Equal To(number)
Imposta i criteri di filtro per mostrare le celle con un numero maggiore o uguale a quello specificato.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero più basso da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Less Than(number)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero più basso da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Less Than Or Equal To(number)
Imposta i criteri di filtro per mostrare le celle con un numero minore o uguale a quello specificato.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero più alto da mostrare. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Not Between(start, end)
Imposta i criteri di filtro per mostrare le celle con un numero non compreso tra due numeri specificati e che non è nessuno dei due.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il numero più basso è nascosto. |
end | Number | Il numero più alto da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Not Equal To(number)
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 questi criteri con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi il filtro deve essere un numero. Se i dati non sono collegati a un database, il tipo di dati della colonna in base alla quale viene applicato il filtro 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
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il numero da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Number Not Equal To Any(numbers)
Imposta i criteri di filtro per mostrare le celle con un numero diverso da uno dei numeri specificati.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
numbers | Number[] | I numeri da nascondere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Contains(text)
Imposta i criteri di filtro per mostrare le celle con testo contenente 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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo che la cella deve contenere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Does Not Contain(text)
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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo che la cella non deve contenere. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Ends With(text)
Imposta i criteri di filtro in modo da mostrare le celle con il 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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo che deve contenere la fine del testo della cella. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Equal To(text)
Imposta i criteri di filtro per mostrare le celle con il 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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo a cui deve corrispondere il testo della cella. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Equal To Any(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.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
texts | String[] | I valori di testo a cui deve corrispondere una cella. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Not Equal To(text)
Imposta i criteri di filtro per mostrare le celle con testo diverso da quello specificato. Il testo non è sensibile alle maiuscole.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo a cui non può corrispondere il testo della cella. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Not Equal To Any(texts)
Imposta i criteri di filtro per mostrare le celle con testo diverso da uno dei valori specificati. Il testo non è sensibile alle maiuscole.
Puoi utilizzare questi criteri solo con i dati collegati a un database. Ad esempio, utilizza questi criteri con i filtri in un foglio Data
, un foglio collegato a un database o un Data
, una tabella pivot creata da un foglio Data
.
// 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
Nome | Tipo | Descrizione |
---|---|---|
texts | String[] | I valori di testo a cui una cella non può essere uguale. |
Invio
Filter
: questo generatore, per l'accodamento.
when Text Starts With(text)
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
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo che deve contenere l'inizio del testo della cella. |
Invio
Filter
: questo generatore, per l'accodamento.
with Criteria(criteria, args)
Imposta i criteri di filtro su una condizione booleana definita dai valori Boolean
, ad esempio CELL_EMPTY
o NUMBER_GREATER_THAN
. Per copiare la condizione booleana dai criteri esistenti, definisci i parametri per questo metodo utilizzando get
e get
in un criterio esistente.
Puoi utilizzare questi criteri con qualsiasi tipo di filtro, ma alcuni Boolean
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
Nome | Tipo | Descrizione |
---|---|---|
criteria | Boolean | Il tipo di criteri booleani. |
args | Object[] | Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e il loro tipo corrispondono ai metodi when...() corrispondenti sopra indicati. |
Invio
Filter
: questo generatore, per l'accodamento.