Bir filtreye ölçüt eklemek için aşağıdakileri yapmanız gerekir:
SpreadsheetApp.newFilterCriteria()
ile ölçüt oluşturucuyu oluşturun.- Bu sınıftaki yöntemleri kullanarak derleyiciye ayarlar ekleyin.
- Ölçütleri belirttiğiniz ayarlarla derlemek için
build()
kullanın.
Yaygın kullanım alanları
Sayfadaki değerleri gizleme
Aşağıdaki örnek, bir sayfanın mevcut filtresini alır ve C sütununda "merhaba" veya "dünya" içeren hücreleri gizleyen ölçütler ekler. Bu örnekteki ölçütler yalnızca varsayılan sayfa türü olanGrid
sayfadaki filtrelerle kullanılabilir.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
Yalnızca boş olmayan hücreleri göster
Aşağıdaki örnek birDataSource
sayfasına, veritabanına bağlı bir sayfa olan ve "Kategori" sütununda yalnızca boş olmayan hücreleri gösteren bir filtre ekler.
// 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);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
build() | FilterCriteria | Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini birleştirir. |
copy() | FilterCriteriaBuilder | Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur. |
getCriteriaType() | BooleanCriteria | Ölçütün boole türünü döndürür (örneğin, CELL_EMPTY ). |
getCriteriaValues() | Object[] | Boole ölçütleri için bir bağımsız değişken dizisi döndürür. |
getHiddenValues() | String[] | Filtrenin gizlediği değerleri döndürür. |
getVisibleBackgroundColor() | Color | Filtre ölçütü olarak kullanılan arka plan rengini döndürür. |
getVisibleForegroundColor() | Color | Filtre ölçütü olarak kullanılan ön plan rengini döndürür. |
getVisibleValues() | String[] | Pivot tablo filtresinin gösterdiği değerleri döndürür. |
setHiddenValues(values) | FilterCriteriaBuilder | Gizlenecek değerleri ayarlar. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Filtre ölçütü olarak kullanılan arka plan rengini ayarlar. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Filtre ölçütü olarak kullanılan ön plan rengini ayarlar. |
setVisibleValues(values) | FilterCriteriaBuilder | Pivot tabloda gösterilecek değerleri ayarlar. |
whenCellEmpty() | FilterCriteriaBuilder | Filtre ölçütlerini boş hücreleri gösterecek şekilde ayarlar. |
whenCellNotEmpty() | FilterCriteriaBuilder | Filtre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar. |
whenDateAfter(date) | FilterCriteriaBuilder | Belirtilen tarihten sonra gelen hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateAfter(date) | FilterCriteriaBuilder | Belirtilen göreli tarihten sonraki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateBefore(date) | FilterCriteriaBuilder | Belirtilen tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateBefore(date) | FilterCriteriaBuilder | Belirtilen göreli tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Belirtilen tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Belirtilen göreli tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Filtre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Filtre ölçütlerini, tarihleri belirtilen tarihlerden hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Filtre ölçütlerini, true olarak değerlendirilen belirtilen bir formüle (=B:B<C:C gibi) sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen 2 sayının arasında veya bu 2 sayının arasında bir sayı olan hücreleri gösterecek şekilde ayarlar. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayılardan herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan büyük bir sayı içeren hücreleri gösterecek şekilde ayarlar |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan büyük veya bu sayıya eşit olan hücreleri gösterecek şekilde ayarlar. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıdan küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen 2 sayıdan biri olmayan ve bu sayılar arasında yer almayan hücreleri gösterecek şekilde ayarlar. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıya eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen sayıların hiçbirine eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar. |
whenTextContains(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metni içermeyen metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metinle biten metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metne eşit metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metin değerlerinden herhangi birine eşit metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metne eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen değerlerden hiçbirine eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar. |
whenTextStartsWith(text) | FilterCriteriaBuilder | Filtre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar. |
withCriteria(criteria, args) | FilterCriteriaBuilder | Filtre ölçütlerini CELL_EMPTY veya NUMBER_GREATER_THAN gibi BooleanCriteria değerleriyle tanımlanan bir boole koşuluna ayarlar. |
Ayrıntılı belgeler
build()
Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini birleştirir.
// 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);
Return
FilterCriteria
: Filtre ölçütlerini temsil eder.
copy()
Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.
Bu yöntemi tüm filtre türleriyle kullanabilirsiniz. Sayfa filtresi kullanıyorsanız ölçütleri başka bir sütuna kopyalayabilirsiniz.
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);
Return
FilterCriteriaBuilder
: Bu filtre ölçütlerini temel alan bir filtre ölçütü oluşturucu.
getCriteriaType()
Ölçütün boole türünü döndürür (örneğin, CELL_EMPTY
). Boole ölçütü türleri hakkında bilgi edinmek için BooleanCriteria
sıralamasına bakın.
Kullanıcılar genellikle bu yöntemi mevcut ölçütleri değiştirmeden bir filtreye boole koşulu ölçütleri eklemek için kullanır.
- Ölçütlerin bağımsız değişkenlerini almak için
getCriteriaValues()
işlevini kullanın. - Filtre ölçütlerini oluşturmak veya değiştirmek amacıyla ölçüt türünü ve ölçüt değerlerini kullanmak için
withCriteria(criteria, args)
bölümüne bakın.
Bu yöntemi tüm filtre türleri için kullanabilirsiniz. Filtre ölçütü bir boole koşulu değilse null
değerini döndürür.
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);
Return
BooleanCriteria
— Boole ölçütünün türü. Ölçüt bir boole koşulu değilse null
.
getCriteriaValues()
Boole ölçütleri için bir bağımsız değişken dizisi döndürür. Bazı boole ölçüt türlerinin bağımsız değişkenleri yoktur ve boş bir dizi döndürür. Örneğin, CELL_NOT_EMPTY
.
Kullanıcılar genellikle bu yöntemi mevcut ölçütleri değiştirmeden bir filtreye boole koşulu ölçütleri eklemek için kullanır.
- Boole ölçüt türünü almak için
getCriteriaType()
işlevini kullanın. - Filtre ölçütü oluşturmak veya değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için
withCriteria(criteria, args)
bölümüne bakın.Bu yöntemi tüm filtre türleri için kullanabilirsiniz.
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);
Return
Object[]
: Boole ölçüt türüne uygun bir bağımsız değişken dizisi. Bağımsız değişkenlerin sayısı ve türleri,FilterCriteriaBuilder
sınıfının karşılık gelenwhen...()
yöntemiyle eşleşir.
getHiddenValues()
Filtrenin gizlediği değerleri döndürür.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Diğer filtre türleri için bu yöntemi çağırırsanız null
değerini döndürür.
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);
Return
String[]
: Filtrenin gizlediği bir değer dizisi.
getVisibleBackgroundColor()
Filtre ölçütü olarak kullanılan arka plan rengini döndürür. Bu arka plan rengine sahip hücreler görünür kalır.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Diğer filtre türleri için bu yöntemi çağırırsanız null
değerini döndürür.
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);
Return
Color
: Filtre ölçütü olarak kullanılan arka plan rengi.
getVisibleForegroundColor()
Filtre ölçütü olarak kullanılan ön plan rengini döndürür. Bu ön plan rengine sahip hücreler görünür durumda kalır.
Bu ölçütleri, varsayılan sayfa türü olan Grid
sayfadaki filtrelerle kullanın.
Diğer filtre türleri için bu yöntemi çağırırsanız null
değerini döndürür.
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);
Return
Color
: Filtre ölçütü olarak kullanılan ön plan rengi.
getVisibleValues()
Pivot tablo filtresinin gösterdiği değerleri döndürür.
Bu ölçüt yalnızca bir veritabanına bağlı olmayan pivot tablolardaki filtreler içindir. Diğer filtre türleri için boş bir dizi döndürür.
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);
Return
String[]
: Pivot tablo filtresinin gösterdiği bir değer dizisi.
setHiddenValues(values)
Gizlenecek değerleri ayarlar. Mevcut görünür veya gizli değerleri temizler.
Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid
sayfalarındaki filtreler için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Gizlenecek değerlerin listesi. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleBackgroundColor(visibleBackgroundColor)
Filtre ölçütü olarak kullanılan arka plan rengini ayarlar. Bu arka plan rengine sahip hücreler görünür kalır. Bir arka plan renk filtresi ölçütü ayarlamak, geçerli renk filtresi ölçütlerini bu oluşturucudan kaldırır.
Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid
sayfalarındaki filtreler için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
visibleBackgroundColor | Color | Ayarlanacak arka plan rengi. Renk, RGB tarzı bir renk olmalıdır. Bu yöntem tema renklerini desteklemez. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleForegroundColor(visibleForegroundColor)
Filtre ölçütü olarak kullanılan ön plan rengini ayarlar. Bu ön plan rengine sahip hücreler görünür durumda kalır. Ön plan renk filtresi ölçütü ayarlamak, geçerli renk filtresi ölçütlerini bu oluşturucudan kaldırır.
Bu ölçütleri yalnızca varsayılan sayfa türü olan Grid
sayfalarındaki filtreler için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
visibleForegroundColor | Color | Ayarlanacak ön plan rengi. Renk, RGB tarzı bir renk olmalıdır. Bu yöntem tema renklerini desteklemez. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
setVisibleValues(values)
Pivot tabloda gösterilecek değerleri ayarlar. Mevcut görünür veya gizli değerleri temizler.
Bu ölçütleri yalnızca bir veritabanına bağlı olmayan pivot tablolardaki filtreler için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Gösterilecek değerlerin listesi. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenCellEmpty()
Filtre ölçütlerini boş hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenCellNotEmpty()
Filtre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateAfter(date)
Belirtilen tarihten sonra gelen hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek en son tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateAfter(date)
Belirtilen göreli tarihten sonraki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
'a bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | En son göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateBefore(date)
Belirtilen tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek en erken tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateBefore(date)
Belirtilen göreli tarihten önce gelen hücreleri gösteren filtre ölçütlerini ayarlar.
Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
'a bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | Gizlenecek en eski göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualTo(date)
Belirtilen tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Hücre değerlerinin eşleşmesi gereken tarihtir. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualTo(date)
Belirtilen göreli tarihe eşit tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate
'a bakın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü tarih olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün tarih olması gerekmez ancak bağlı değilse beklenmeyen sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | RelativeDate | Hücre değerlerinin eşleşmesi gereken göreli tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateEqualToAny(dates)
Filtre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dates | Date[] | Gösterilecek tarihler. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateNotEqualTo(date)
Filtre ölçütlerini, belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
Filtreleme ölçütü olarak kullandığınız sütunun veri türü tarih olmalıdır.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Gizlenecek tarih. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenDateNotEqualToAny(dates)
Filtre ölçütlerini, tarihleri belirtilen tarihlerden hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dates | Date[] | Gizlenecek tarihler. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenFormulaSatisfied(formula)
Filtre ölçütlerini, true
olarak değerlendirilen belirtilen bir formüle (=B:B<C:C
gibi) sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı olmayan verileri filtrelemek için kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Giriş geçerliyse true sonucunu veren özel bir formül. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberBetween(start, end)
Filtre ölçütlerini, belirtilen 2 sayının arasında veya bu 2 sayının arasında bir sayı olan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | Gösterilecek en düşük sayı. |
end | Number | Gösterilecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberEqualTo(number)
Filtre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberEqualToAny(numbers)
Filtre ölçütlerini, belirtilen sayılardan herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numbers | Number[] | Gösterilecek sayılar. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberGreaterThan(number)
Filtre ölçütlerini, belirtilen sayıdan büyük bir sayı içeren hücreleri gösterecek şekilde ayarlar
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberGreaterThanOrEqualTo(number)
Filtre ölçütlerini, belirtilen sayıdan büyük veya bu sayıya eşit olan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek en düşük sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberLessThan(number)
Filtre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek en düşük sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberLessThanOrEqualTo(number)
Filtre ölçütlerini, belirtilen sayıdan küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gösterilecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotBetween(start, end)
Filtre ölçütlerini, belirtilen 2 sayıdan biri olmayan ve bu sayılar arasında yer almayan hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | En düşük sayı gizlenir. |
end | Number | Gizlenecek en yüksek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotEqualTo(number)
Filtre ölçütlerini, belirtilen sayıya eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri bir veritabanına bağlı verilerle kullanıyorsanız filtrelediğiniz sütunun veri türü sayı olmalıdır. Veriler bir veritabanına bağlı değilse filtrelediğiniz sütunun veri türünün sayı olması gerekmez ancak sayı değilse beklenmedik sonuçlar alabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Gizlenecek sayı. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenNumberNotEqualToAny(numbers)
Filtre ölçütlerini, belirtilen sayıların hiçbirine eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numbers | Number[] | Gizlenecek sayılar. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextContains(text)
Filtre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücrenin içermesi gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextDoesNotContain(text)
Filtre ölçütlerini, belirtilen metni içermeyen metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücrenin içermemesi gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEndsWith(text)
Filtre ölçütlerini, belirtilen metinle biten metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin sonunda yer alması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEqualTo(text)
Filtre ölçütlerini, belirtilen metne eşit metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücredeki metnin eşit olması gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextEqualToAny(texts)
Filtre ölçütlerini, belirtilen metin değerlerinden herhangi birine eşit metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
texts | String[] | Bir hücrenin eşit olması gereken metin değerleri. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextNotEqualTo(text)
Filtre ölçütlerini, belirtilen metne eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücredeki metnin eşit olamayacağı metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextNotEqualToAny(texts)
Filtre ölçütlerini, belirtilen değerlerden hiçbirine eşit olmayan metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource
sayfasındaki filtreler, veri tabanına bağlı bir sayfa veya DataSourcePivotTable
(DataSource
sayfasından oluşturulmuş bir pivot tablo) ile kullanın.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
texts | String[] | Bir hücrenin eşit olamayacağı metin değerleri. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
whenTextStartsWith(text)
Filtre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Hücre metninin başlangıcının içermesi gereken metin. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.
withCriteria(criteria, args)
Filtre ölçütlerini CELL_EMPTY
veya NUMBER_GREATER_THAN
gibi BooleanCriteria
değerleriyle tanımlanan bir boole koşuluna ayarlar. Boole koşulunu mevcut ölçütlerden kopyalamak için mevcut ölçütlerde getCriteriaType()
ve getCriteriaValues()
kullanarak bu yöntemin parametrelerini tanımlayın.
Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz, ancak bazı BooleanCriteria
tüm filtreler için geçerli değildir.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
criteria | BooleanCriteria | Boole ölçütlerinin türü. |
args | Object[] | Ölçüt türüne uygun bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü, yukarıdaki ilgili when...() yöntemleriyle eşleşir. |
Return
FilterCriteriaBuilder
— Zincirleme için bu oluşturucu.