Aby dodać kryteria do filtra, musisz:
- Utwórz kreator kryteriów za pomocą narzędzia
SpreadsheetApp.newFilterCriteria()
. - Dodaj ustawienia do konstruktora, korzystając z metod z tej klasy.
- Użyj operatora
build()
, aby utworzyć kryteria o określonych ustawieniach.
Typowe zastosowania
Ukrywanie wartości w arkuszu
Poniższy przykład powoduje pobranie arkusza i dodanie kryteriów, które ukrywają komórki w kolumnie C zawierające "hello" lub "world." Kryteria z tej próby mogą być używane tylko z filtrami w arkuszachGrid
, domyślnym typie arkusza.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
Pokaż tylko niepuste komórki
Poniższy przykładowy kod dodaje do arkuszaDataSource
arkusz, który jest połączony z bazą danych, i zawiera kryteria, które pokazują tylko kolumny z kolumny „Kategoria”.
// 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);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | FilterCriteria | Przygotuj kryteria filtra, korzystając z ustawień dodanych do kreatora kryteriów. |
copy() | FilterCriteriaBuilder | Kopiuje te kryteria filtrowania i tworzy narzędzie do ich stosowania. |
getCriteriaType() | BooleanCriteria | Zwraca typ logiczny kryteriów, np. CELL_EMPTY . |
getCriteriaValues() | Object[] | Zwraca tablicę argumentów na potrzeby kryteriów logicznych. |
getHiddenValues() | String[] | Zwraca wartości ukryte przez filtr. |
getVisibleBackgroundColor() | Color | Zwraca kolor tła używany jako kryterium filtra. |
getVisibleForegroundColor() | Color | Zwraca kolor pierwszego planu używany jako kryterium filtra. |
getVisibleValues() | String[] | Zwraca wartości wyświetlane przez filtr tabeli przestawnej. |
setHiddenValues(values) | FilterCriteriaBuilder | Ustawia wartości do ukrycia. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Ustawia kolor tła używany jako kryterium filtra. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Ustawia kolor pierwszego planu używany jako kryterium filtra. |
setVisibleValues(values) | FilterCriteriaBuilder | Ustawia wartości wyświetlane w tabeli przestawnej. |
whenCellEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania na puste komórki. |
whenCellNotEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są puste. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datami po określonej dacie. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtra zawierające komórki z datami późniejszymi niż określona data względna. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datami sprzed określonej daty. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datami poprzedzającymi określoną datę względną. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datą równą określonej dacie. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datami określonymi w przypadku określonej daty względnej. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, których data jest równa dowolnej z podanych dat. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są równe określonej dacie. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby wyświetlały się komórki, których data nie jest równa żadnej z określonych dat. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby wyświetlały komórki z określoną formułą (np. =B:B<C:C ), która ocenia true . |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w których liczba mieści się w 2 zakresach lub jest jedną z tych wartości. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z liczbą równą określonej liczbie. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlały się komórki z liczbą, która jest równa dowolnej z określonych liczb. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki o liczbie większej niż określona |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtra, aby wyświetlić komórki z liczbą większą lub równą określonej liczbie. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w przypadku których liczba jest mniejsza od określonej liczby. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtra, tak aby wyświetlały się w komórce liczby, które nie należą do żadnej z dwóch liczb. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa określonej liczbie. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa żadnej z określonych liczb. |
whenTextContains(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały komórki zawierające tekst. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie zawiera podanego tekstu. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem kończącym się na określonym tekście. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem równym określonemu tekstowi. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który jest równy dowolnej z określonych wartości tekstowych. |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w celu wyświetlania komórek z tekstem, który nie jest równy określonemu tekstowi. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie jest zgodny z określoną wartością. |
whenTextStartsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem zaczynającym się od określonego tekstu. |
withCriteria(criteria, args) | FilterCriteriaBuilder | Ustawia warunek filtra na wartość logiczną zdefiniowaną przez wartości BooleanCriteria , np. CELL_EMPTY lub NUMBER_GREATER_THAN . |
Szczegółowa dokumentacja
build()
Przygotuj kryteria filtra, korzystając z ustawień dodanych do kreatora kryteriów.
// 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);
Zwróć
FilterCriteria
– przedstawienie kryteriów filtrowania.
copy()
Kopiuje te kryteria filtrowania i tworzy narzędzie do ich stosowania.
Tej metody możesz używać z różnymi typami filtrów. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.
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);
Zwróć
FilterCriteriaBuilder
– narzędzie do tworzenia kryteriów filtrowania oparte na tych kryteriach.
getCriteriaType()
Zwraca typ logiczny kryteriów, np. CELL_EMPTY
. Aby dowiedzieć się więcej o typach kryteriów logicznych, zobacz wyliczenie BooleanCriteria
.
Użytkownicy często używają tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych.
- Aby otrzymać argumenty kryteriów, użyj funkcji
getCriteriaValues()
. - Aby użyć typów i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtrowania, otwórz stronę
withCriteria(criteria, args)
.
Możesz użyć tej metody w przypadku dowolnego typu filtra. Jeśli kryterium filtra jest warunku logicznem, zwraca 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);
Zwróć
BooleanCriteria
– typ kryteriów logicznych, a null
– jeśli warunek jest wartością logiczną.
getCriteriaValues()
Zwraca tablicę argumentów na potrzeby kryteriów logicznych. Niektóre typy kryteriów logicznych nie zawierają argumentów i zwracają pustą tablicę, na przykład CELL_NOT_EMPTY
.
Użytkownicy często używają tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych.
- Aby uzyskać typ kryterium logicznego, użyj
getCriteriaType()
. - Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtra, zapoznaj się z artykułem
withCriteria(criteria, args)
.Możesz użyć tej metody w przypadku dowolnego typu filtra.
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);
Zwróć
Object[]
– tablica argumentów odpowiednich dla typu kryteriów logicznych. Liczba argumentów i ich typu są zgodne z odpowiednią metodąwhen...()
klasyFilterCriteriaBuilder
.
getHiddenValues()
Zwraca wartości ukryte przez filtr.
Użyj tych kryteriów w filtrach w arkuszach Grid
– domyślnym typie arkusza.
Zwraca null
, jeśli wywołasz tę metodę w przypadku innych typów filtrów.
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);
Zwróć
String[]
– tablica wartości ukrywanych przez filtr.
getVisibleBackgroundColor()
Zwraca kolor tła używany jako kryterium filtra. Komórki z tym kolorem tła są nadal widoczne.
Użyj tych kryteriów w filtrach w arkuszach Grid
– domyślnym typie arkusza.
Zwraca null
, jeśli wywołasz tę metodę w przypadku innych typów filtrów.
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);
Zwróć
Color
– kolor tła używany jako kryterium filtrowania;
getVisibleForegroundColor()
Zwraca kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem na pierwszym planie pozostają widoczne.
Użyj tych kryteriów w filtrach w arkuszach Grid
– domyślnym typie arkusza.
Zwraca null
, jeśli wywołasz tę metodę w przypadku innych typów filtrów.
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);
Zwróć
Color
– kolor pierwszego planu używany jako kryterium filtra.
getVisibleValues()
Zwraca wartości wyświetlane przez filtr tabeli przestawnej.
Te kryteria dotyczą tylko filtrów w tabelach przestawnych, które nie są połączone z bazą danych. Zwraca pustą tablicę w przypadku innych typów filtrów.
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);
Zwróć
String[]
– tablica wartości wyświetlanych przez filtr tabeli przestawnej.
setHiddenValues(values)
Ustawia wartości do ukrycia. Usuwa wszystkie widoczne lub ukryte wartości.
Tench kryteriów można używać tylko w filtrach arkuszy Grid
– domyślnego typu arkusza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
setVisibleBackgroundColor(visibleBackgroundColor)
Ustawia kolor tła używany jako kryterium filtra. Komórki z tym kolorem tła są nadal widoczne. Ustawienie kryteriów filtrowania kolorów tła spowoduje usunięcie z tego kreatora wszystkich bieżących filtrów.
Tench kryteriów można używać tylko w filtrach arkuszy Grid
– domyślnego typu arkusza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
visibleBackgroundColor | Color | Kolor tła do ustawienia. Musi być to kolor RGB. Ta metoda nie obsługuje kolorów motywu. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
setVisibleForegroundColor(visibleForegroundColor)
Ustawia kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem na pierwszym planie pozostają widoczne. Ustawienie kryteriów filtrowania kolorów pierwszego planu spowoduje usunięcie z tego kreatora wszystkich bieżących kryteriów filtrowania kolorów.
Tench kryteriów można używać tylko w filtrach arkuszy Grid
– domyślnego typu arkusza.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
visibleForegroundColor | Color | Kolor pierwszego planu do ustawienia. Musi być to kolor RGB. Ta metoda nie obsługuje kolorów motywu. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
setVisibleValues(values)
Ustawia wartości wyświetlane w tabeli przestawnej. Usuwa wszystkie widoczne lub ukryte wartości.
Tego kryterium możesz użyć tylko w przypadku filtrów w tabelach przestawnych, które nie są połączone z bazą danych.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenCellEmpty()
Ustawia kryteria filtrowania na puste komórki.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenCellNotEmpty()
Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są puste.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtrowania zawierające komórki z datami po określonej dacie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najnowsza data do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtra zawierające komórki z datami późniejszymi niż określona data względna. Informacje o względnych opcjach dat znajdziesz w sekcji Enum RelativeDate
.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najnowsza data względna. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateBefore(date)
Ustawia kryteria filtrowania zawierające komórki z datami sprzed określonej daty.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześniejsza data ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateBefore(date)
Ustawia kryteria filtrowania zawierające komórki z datami poprzedzającymi określoną datę względną.
Aby wyświetlić względne opcje dat, przeczytaj artykuł Wyliczenie RelativeDate
.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najwcześniejsza data względna do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateEqualTo(date)
Ustawia kryteria filtrowania zawierające komórki z datą równą określonej dacie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Data, którą wartości muszą się zgadzać. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateEqualTo(date)
Ustawia kryteria filtrowania zawierające komórki z datami określonymi w przypadku określonej daty względnej.
Aby wyświetlić względne opcje dat, przeczytaj artykuł Wyliczenie RelativeDate
.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Względna data, dla której wartości komórek muszą się zgadzać. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateEqualToAny(dates)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, których data jest równa dowolnej z podanych dat.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
dates | Date[] | Daty do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateNotEqualTo(date)
Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są równe określonej dacie.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza DataSource
.
Typ danych w kolumnie, według której filtrujesz, musi być datą.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Data ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenDateNotEqualToAny(dates)
Ustawia kryteria filtra tak, aby wyświetlały się komórki, których data nie jest równa żadnej z określonych dat.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
dates | Date[] | Daty do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenFormulaSatisfied(formula)
Ustawia kryteria filtra tak, aby wyświetlały komórki z określoną formułą (np. =B:B<C:C
), która ocenia true
.
Te kryteria możesz stosować tylko do filtrowania danych, które nie są połączone z bazą danych.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Niestandardowa formuła, która zwraca wartość true , jeśli dane wejściowe są prawidłowe. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberBetween(start, end)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w których liczba mieści się w 2 zakresach lub jest jedną z tych wartości.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa liczba do wyświetlenia. |
end | Number | Najwyższa liczba do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberEqualTo(number)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z liczbą równą określonej liczbie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Numer do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberEqualToAny(numbers)
Ustawia kryteria filtrowania tak, aby wyświetlały się komórki z liczbą, która jest równa dowolnej z określonych liczb.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
numbers | Number[] | Numery do pokazania. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberGreaterThan(number)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki o liczbie większej niż określona
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa liczba do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberGreaterThanOrEqualTo(number)
Ustawia kryteria filtra, aby wyświetlić komórki z liczbą większą lub równą określonej liczbie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa liczba do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberLessThan(number)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w przypadku których liczba jest mniejsza od określonej liczby.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa liczba do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberLessThanOrEqualTo(number)
Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa liczba do wyświetlenia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberNotBetween(start, end)
Ustawia kryteria filtra, tak aby wyświetlały się w komórce liczby, które nie należą do żadnej z dwóch liczb.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Ukryj najniższy numer. |
end | Number | Najwyższa liczba do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberNotEqualTo(number)
Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa określonej liczbie.
Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Numer do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenNumberNotEqualToAny(numbers)
Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa żadnej z określonych liczb.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
numbers | Number[] | Numery do ukrycia. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextContains(text)
Ustawia kryteria filtrowania, tak aby wyświetlały komórki zawierające tekst. W tekście nie jest rozróżniana wielkość liter.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst zawierający komórkę. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextDoesNotContain(text)
Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie zawiera podanego tekstu. W tekście nie jest rozróżniana wielkość liter.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który nie może zawierać komórki. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextEndsWith(text)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem kończącym się na określonym tekście. W tekście nie jest rozróżniana wielkość liter.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który musi zawierać koniec komórki. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextEqualTo(text)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem równym określonemu tekstowi. W tekście nie jest rozróżniana wielkość liter.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst w komórce musi być taki sam. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextEqualToAny(texts)
Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który jest równy dowolnej z określonych wartości tekstowych. W tekście nie jest rozróżniana wielkość liter.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
texts | String[] | Wartości tekstowe, które komórka musi być równa. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextNotEqualTo(text)
Ustawia kryteria filtrowania w celu wyświetlania komórek z tekstem, który nie jest równy określonemu tekstowi. W tekście nie jest rozróżniana wielkość liter.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, którego komórka nie jest równa. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextNotEqualToAny(texts)
Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie jest zgodny z określoną wartością. W tekście nie jest rozróżniana wielkość liter.
Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
, która została utworzona na podstawie arkusza 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
texts | String[] | Wartości tekstowe, których komórka nie może być równa. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
whenTextStartsWith(text)
Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem zaczynającym się od określonego tekstu. W tekście nie jest rozróżniana wielkość liter.
Tych kryteriów możesz użyć z dowolnym typem filtra.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który musi zawierać początek komórki. |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.
withCriteria(criteria, args)
Ustawia warunek filtra na wartość logiczną zdefiniowaną przez wartości BooleanCriteria
, np. CELL_EMPTY
lub NUMBER_GREATER_THAN
. Aby skopiować warunek logiczny z istniejących kryteriów, zdefiniuj parametry tej metody za pomocą właściwości getCriteriaType()
i getCriteriaValues()
.
Te kryteria można stosować z dowolnym typem filtra, ale niektóre filtry (BooleanCriteria
) nie mają zastosowania do wszystkich filtrów.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
criteria | BooleanCriteria | Typ kryteriów logicznych. |
args | Object[] | Tablica argumentów odpowiednich dla typu kryterium. Liczba argumentów i ich typu odpowiada danym when...() . |
Zwróć
FilterCriteriaBuilder
– ten łańcuch do tworzenia łańcuchów.