Class FilterCriteriaBuilder

FilterCriteriaBuilder

Per aggiungere criteri a un filtro, devi eseguire le seguenti operazioni:

  1. Crea il generatore di criteri utilizzando SpreadsheetApp.newFilterCriteria().
  2. Aggiungi impostazioni allo strumento di creazione utilizzando i metodi di questa classe.
  3. Utilizza build() per combinare i criteri con le impostazioni specificate.

Utilizzi comuni

Nascondere i valori in un foglio

Il seguente esempio ottiene il filtro esistente di un foglio e aggiunge criteri che nascondono le celle in colonna C che contiene "hello" o "mondo". I criteri di questo campione possono essere utilizzati solo con filtri su fogli Grid, 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, ovvero a un foglio collegate a un database, con criteri che mostrano solo le celle nella "Categoria" colonna che non siano vuoti.
// 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

MetodoTipo restituitoBreve descrizione
build()FilterCriteriaAssembla i criteri di filtro utilizzando le impostazioni aggiunte al generatore di criteri.
copy()FilterCriteriaBuilderCopia questi criteri di filtro e crea un generatore di criteri che è possibile applicare a un altro filtro.
getCriteriaType()BooleanCriteriaRestituisce il tipo booleano del criterio, ad esempio CELL_EMPTY.
getCriteriaValues()Object[]Restituisce un array di argomenti per i criteri booleani.
getHiddenValues()String[]Restituisce i valori che il filtro nasconde.
getVisibleBackgroundColor()ColorRestituisce il colore di sfondo utilizzato come criterio di filtro.
getVisibleForegroundColor()ColorRestituisce il colore in primo piano utilizzato come criterio di filtro.
getVisibleValues()String[]Restituisce i valori visualizzati dal filtro della tabella pivot.
setHiddenValues(values)FilterCriteriaBuilderConsente di impostare i valori da nascondere.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderImposta il colore di sfondo utilizzato come criterio di filtro.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderImposta il colore in primo piano utilizzato come criterio di filtro.
setVisibleValues(values)FilterCriteriaBuilderImposta i valori da mostrare in una tabella pivot.
whenCellEmpty()FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle vuote.
whenCellNotEmpty()FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle che non sono vuote.
whenDateAfter(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date successive a quella specificata.
whenDateAfter(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date successive alla data relativa specificata.
whenDateBefore(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date antecedenti alla data specificata.
whenDateBefore(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date antecedenti alla data relativa specificata.
whenDateEqualTo(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date corrispondenti alla data specificata.
whenDateEqualTo(date)FilterCriteriaBuilderConsente di impostare criteri di filtro che mostrano le celle con date uguali alla data relativa specificata.
whenDateEqualToAny(dates)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con date uguali a una qualsiasi delle date specificate.
whenDateNotEqualTo(date)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle che non corrispondono alla data specificata.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con date diverse da quelle specificate date.
whenFormulaSatisfied(formula)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con una formula specificata (ad esempio =B:B<C:C) che restituisce true.
whenNumberBetween(start, end)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero che rientra tra 2 o è uno dei due numeri specificati.
whenNumberEqualTo(number)FilterCriteriaBuilderImposta i criteri di filtro per visualizzare le celle con un numero uguale al numero specificato.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero uguale a uno qualsiasi dei valori specificati numeri.
whenNumberGreaterThan(number)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero maggiore di quello specificato
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderImposta i criteri di filtro per visualizzare le celle con un numero maggiore o uguale al valore specificato numero.
whenNumberLessThan(number)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero inferiore al numero specificato.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderImposta i criteri di filtro per visualizzare le celle con un numero inferiore o uguale al valore specificato numero.
whenNumberNotBetween(start, end)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero che non rientrano tra e non è nessuno di 2 numeri specificati.
whenNumberNotEqualTo(number)FilterCriteriaBuilderImposta i criteri di filtro per visualizzare le celle con un numero diverso dal numero specificato.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderImposta i criteri di filtro per mostrare le celle con un numero diverso da uno dei valori specificati numeri.
whenTextContains(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con testo che contiene il testo specificato.
whenTextDoesNotContain(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con testo che non contiene il testo specificato.
whenTextEndsWith(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con testo che termina con il testo specificato.
whenTextEqualTo(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con un testo uguale al testo specificato.
whenTextEqualToAny(texts)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con un testo uguale a uno qualsiasi del testo specificato e i relativi valori.
whenTextNotEqualTo(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con un testo diverso dal testo specificato.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con un testo diverso da quello specificato e i relativi valori.
whenTextStartsWith(text)FilterCriteriaBuilderImposta i criteri del filtro per mostrare le celle con un testo che inizia con il testo specificato.
withCriteria(criteria, args)FilterCriteriaBuilderImposta i criteri del filtro su una condizione booleana definita dai valori BooleanCriteria, come come 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);

Invio

FilterCriteria: una rappresentazione dei criteri del filtro.


copy()

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

Puoi utilizzare questo metodo con qualsiasi tipo di filtro. Se utilizzi un filtro del foglio, puoi: copia 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);

Invio

FilterCriteriaBuilder: uno strumento per la creazione dei criteri di filtro basato su questi criteri.


getCriteriaType()

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

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

Puoi utilizzare questo metodo per qualsiasi tipo di filtro. Se i criteri del filtro non sono booleano , 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);

Invio

BooleanCriteria: il tipo di criteri booleani o null se il criterio non è booleano .


getCriteriaValues()

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.

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

  • Per ottenere il tipo di criteri booleani, 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);

    Invio

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


getHiddenValues()

Restituisce i valori che il filtro nasconde.

Usa questo criterio con i filtri sui fogli Grid, 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);

Invio

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


getVisibleBackgroundColor()

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

Usa questo criterio con i filtri sui fogli Grid, 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);

Invio

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


getVisibleForegroundColor()

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

Usa questo criterio con i filtri sui fogli Grid, 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);

Invio

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


getVisibleValues()

Restituisce i valori visualizzati dal filtro della tabella pivot.

Questo criterio riguarda solo i filtri nelle tabelle pivot che non sono collegate 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);

Invio

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


setHiddenValues(values)

Consente di impostare i valori da nascondere. Cancella tutti i valori visibili o nascosti esistenti.

Puoi utilizzare questo criterio solo per i filtri su Grid fogli, l'impostazione predefinita tipo di foglio.

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

NomeTipoDescrizione
valuesString[]L'elenco di valori da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.

Lanci

Error: se uno dei valori è null.


setVisibleBackgroundColor(visibleBackgroundColor)

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

Puoi utilizzare questo criterio solo per i filtri su Grid fogli, l'impostazione predefinita tipo di foglio.

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

NomeTipoDescrizione
visibleBackgroundColorColorIl colore di sfondo da impostare. Il colore deve essere di tipo RGB. colore. Questo metodo non supporta i colori del tema.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


setVisibleForegroundColor(visibleForegroundColor)

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

Puoi utilizzare questo criterio solo per i filtri su Grid fogli, l'impostazione predefinita tipo di foglio.

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

NomeTipoDescrizione
visibleForegroundColorColorIl colore di primo piano da impostare. Il colore deve essere di tipo RGB. colore. Questo metodo non supporta i colori del tema.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


setVisibleValues(values)

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

Puoi utilizzare questo criterio solo per i filtri nelle tabelle pivot non collegate a un per configurare 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

NomeTipoDescrizione
valuesString[]L'elenco di valori da mostrare.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.

Lanci

Error: se uno dei valori è null.


whenCellEmpty()

Imposta i criteri di filtro per mostrare le celle vuote.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
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);

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenCellNotEmpty()

Imposta i criteri di filtro per mostrare le celle che non sono vuote.

Puoi utilizzare questi criteri 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);

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateAfter(date)

Consente di impostare criteri di filtro che mostrano le celle con date successive a quella specificata.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, potresti ottenere risultati inaspettati.

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

NomeTipoDescrizione
dateDateL'ultima data da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateAfter(date)

Consente di impostare criteri di filtro che mostrano le celle con date successive alla data relativa specificata. A visualizza le opzioni per la data relativa, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, potresti ottenere risultati inaspettati.

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

NomeTipoDescrizione
dateRelativeDateL'ultima data relativa.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateBefore(date)

Consente di impostare criteri di filtro che mostrano le celle con date antecedenti alla data specificata.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegato a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, potresti ottenere risultati inaspettati.

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

NomeTipoDescrizione
dateDateLa prima data da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateBefore(date)

Consente di impostare criteri di filtro che mostrano le celle con date antecedenti alla data relativa specificata. Per visualizzare le opzioni per la data relativa, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, 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 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

NomeTipoDescrizione
dateRelativeDateLa prima data relativa da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateEqualTo(date)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, potresti ottenere risultati inaspettati.

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

NomeTipoDescrizione
dateDateLa data in cui i valori delle celle devono corrispondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateEqualTo(date)

Consente di impostare criteri di filtro che mostrano le celle con date uguali alla data relativa specificata. Per visualizzare le opzioni per la data relativa, consulta Enum RelativeDate.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati collegati a un database, il tipo di dati della colonna in base alla quale applichi 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 stai filtrando deve essere una data, ma se non lo è, 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 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

NomeTipoDescrizione
dateRelativeDateLa data relativa in cui i valori delle celle devono corrispondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateEqualToAny(dates)

Imposta i criteri del filtro per mostrare le celle con date uguali a una qualsiasi delle date specificate.

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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

NomeTipoDescrizione
datesDate[]Le date da mostrare.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateNotEqualTo(date)

Imposta i criteri del filtro per mostrare le celle che non corrispondono alla data specificata.

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

Il tipo di dati della colonna in base alla quale applichi il filtro 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

NomeTipoDescrizione
dateDateLa data da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenDateNotEqualToAny(dates)

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

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 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

NomeTipoDescrizione
datesDate[]Le date da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenFormulaSatisfied(formula)

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

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
formulaStringUna formula personalizzata che restituisce true se l'input è valido.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberBetween(start, end)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
startNumberIl numero più basso da mostrare.
endNumberIl numero più alto da mostrare.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberEqualTo(number)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero da mostrare.

Invio

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 valori specificati numeri.

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 "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

NomeTipoDescrizione
numbersNumber[]I numeri da mostrare.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberGreaterThan(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 questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero più alto da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberGreaterThanOrEqualTo(number)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero più basso da mostrare.

Invio

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 questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero più basso da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberLessThanOrEqualTo(number)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero più alto da mostrare.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberNotBetween(start, end)

Imposta i criteri di filtro per mostrare le celle con un numero che non rientrano tra e non è nessuno di 2 numeri specificati.

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
startNumberViene nascosto il numero più basso.
endNumberIl numero più alto da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberNotEqualTo(number)

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

Puoi utilizzare questi criteri con qualsiasi tipo di filtro. Se utilizzi questo criterio con dati connessa 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 stai filtrando deve essere un numero. 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

NomeTipoDescrizione
numberNumberIl numero da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenNumberNotEqualToAny(numbers)

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

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 "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

NomeTipoDescrizione
numbersNumber[]I numeri da nascondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextContains(text)

Imposta i criteri del filtro per mostrare le celle con testo che contiene il testo specificato. Il testo non distingue maiuscole e minuscole.

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
textStringIl testo che deve contenere la cella.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextDoesNotContain(text)

Imposta i criteri del filtro per mostrare le celle con testo che non contiene il testo specificato. La e il testo non fa distinzione tra maiuscole e minuscole.

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
textStringIl testo che la cella non deve contenere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextEndsWith(text)

Imposta i criteri del filtro per mostrare le celle con testo che termina con il testo specificato. Il testo non distingue maiuscole e minuscole.

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
textStringIl testo che deve contenere la fine del testo della cella.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextEqualTo(text)

Imposta i criteri del filtro per mostrare le celle con un testo uguale al testo specificato. Il testo non distingue maiuscole e minuscole.

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
textStringIl testo che deve corrispondere al testo della cella.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextEqualToAny(texts)

Imposta i criteri del filtro per mostrare le celle con un testo uguale a uno qualsiasi del testo specificato e i relativi valori. Il testo non è sensibile alle maiuscole.

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 "category" column that shows cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parametri

NomeTipoDescrizione
textsString[]I valori di testo che una cella deve corrispondere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextNotEqualTo(text)

Imposta i criteri del filtro per mostrare le celle con un testo diverso dal testo specificato. La e il testo non fa distinzione tra maiuscole e minuscole.

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 "category" column that hides cells with text equal to "tech."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualTo("tech")
                             .build();
dataSheet.addFilter("category", criteria);

Parametri

NomeTipoDescrizione
textStringIl testo a cui il testo della cella non può essere uguale.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextNotEqualToAny(texts)

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

Puoi utilizzare questo criterio solo con dati connessi a un database. Ad esempio, utilizza questo criteri con filtri su un foglio DataSource, un foglio collegato a un o 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 "category" column that hides cells with the text "tech" or "business."
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextNotEqualToAny(["tech","business"])
                             .build();
dataSheet.addFilter("category", criteria);

Parametri

NomeTipoDescrizione
textsString[]I valori di testo che una cella non può equivalere.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


whenTextStartsWith(text)

Imposta i criteri del filtro per mostrare le celle con un testo che inizia con il testo specificato. Il testo non distingue maiuscole e minuscole.

Puoi utilizzare questi criteri 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

NomeTipoDescrizione
textStringTesto che deve contenere l'inizio del testo della cella.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.


withCriteria(criteria, args)

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

Puoi utilizzare questo criterio con qualsiasi tipo di filtro, ma alcuni BooleanCriteria non lo sono applicabile 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

NomeTipoDescrizione
criteriaBooleanCriteriaIl tipo di criteri booleani.
argsObject[]Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e il loro tipo corrisponde ai metodi when...() corrispondenti sopra.

Invio

FilterCriteriaBuilder: questo builder, per il concatenamento.