Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class FilterCriteriaBuilder

Bir filtreye ölçüt eklemek için aşağıdakileri yapmanız gerekir:

SpreadsheetApp.newFilterCriteria() kullanarak ölçüt oluşturucuyu oluşturun.
Bu sınıftaki yöntemleri kullanarak oluşturucuya ayar ekleyin.
Ölçütleri, belirttiğiniz ayarlarla birleştirmek için build() simgesini kullanın.

Yaygın kullanım alanları

Sayfadaki değerleri gizleme

Aşağıdaki örnekte, bir sayfanın mevcut filtresi alınır ve C sütununda "merhaba" veya "dünya" içeren hücreleri gizleyen ölçütler eklenir. Bu örnekteki ölçütler yalnızca varsayılan sayfa türü olan Grid sayfalarındaki filtrelerle kullanılabilir.

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

Yalnızca boş olmayan hücreleri göster

Aşağıdaki örnekte, bir veritabanına bağlı bir DataSource sayfasına yalnızca "Kategori" sütunundaki boş olmayan hücreleri gösteren ölçütlerle bir filtre eklenmektedir.

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

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 oluşturur.
`copy()`	`FilterCriteriaBuilder`	Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.
`getCriteriaType()`	`BooleanCriteria`	Ölçütlerin boole türünü döndürür (ör. `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 sonraki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Belirtilen göreli tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Belirtilen tarihten önceki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Belirtilen göreli tarihten önceki tarihlere sahip 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, belirtilen tarihlerden herhangi birine eşit tarihlere sahip 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, belirtilen tarihlerden hiçbirine eşit olmayan tarihlere sahip hücreleri gösterecek şekilde ayarlar.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, `true` değerini döndüren belirli bir formülü (`=B:B<C:C` gibi) içeren hücreleri gösterecek şekilde ayarlar.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, belirtilen 2 sayı arasında veya bu sayılardan biri olan bir sayıya sahip 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ıya sahip hücreleri gösterecek şekilde ayarlar.
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, belirtilen sayıdan büyük veya eşit sayıda hücreleri gösterecek şekilde ayarlar.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, belirtilen sayıdan az sayıda hücre içeren hücreleri gösterecek şekilde ayarlar.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, belirtilen sayıdan az veya eşit sayıda hücreyi gösterecek şekilde ayarlar.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Filtre ölçütlerini, belirtilen 2 sayı arasında olmayan ve bu sayılardan hiçbiri olmayan bir sayıya sahip 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ılardan 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 metin 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, `BooleanCriteria` değerleriyle (ör. `CELL_EMPTY` veya `NUMBER_GREATER_THAN`) tanımlanan bir boole koşuluna ayarlar.

Ayrıntılı dokümanlar

`build()`

Ölçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini oluşturur.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp
                     .newFilterCriteria()  // Creates a criteria builder.
                     .whenCellNotEmpty()   // Adds settings to the builder.
                     .build();             // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteria: Filtre ölçütlerinin gösterimi.

`copy()`

Bu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur.

Bu yöntemi herhangi bir filtre türüyle kullanabilirsiniz. E-tablo filtresi kullanıyorsanız ölçütleri başka bir sütuna kopyalayabilirsiniz.

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any
// existing criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Bu filtre ölçütlerine dayalı bir filtre ölçütleri oluşturucu.

`getCriteriaType()`

Ölçütün boole türünü döndürür (ör. CELL_EMPTY). Boole ölçütlerinin türleri hakkında bilgi edinmek için BooleanCriteria enum'a bakın.

Kullanıcılar genellikle mevcut ölçütleri değiştirmeden bir filtreye mantıksal koşul ölçütü eklemek için bu yöntemi kullanır.

Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() değerini kullanın.
Filtre ölçütleri oluşturmak veya değiştirmek için ölçüt türünü ve ölçüt değerlerini kullanmak istiyorsanız withCriteria(criteria, args) başlıklı makaleyi inceleyin.

Bu yöntemi herhangi bir filtre türü için kullanabilirsiniz. Filtre ölçütleri bir Boole koşulu değilse null değerini döndürür.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
const filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type
// object.
const criteriaType =
    filter.getColumnFilterCriteria(2).getCriteriaType().toString();
// Logs the criteria type.
console.log(criteriaType);

Return

BooleanCriteria: Boole ölçütünün türü veya ö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ürleri bağımsız değişken içermez ve boş bir dizi döndürür (ör. CELL_NOT_EMPTY).

Kullanıcılar genellikle mevcut ölçütleri değiştirmeden bir filtreye mantıksal koşul ölçütü eklemek için bu yöntemi kullanır.

Boole ölçütü türünü almak için getCriteriaType() değerini kullanın.
Filtre ölçütü oluşturmak veya değiştirmek için ölçüt türünü ve ölçüt değerlerini kullanmak istiyorsanız withCriteria(criteria, args) başlıklı makaleyi inceleyin.
Bu yöntemi herhangi bir filtre türü için kullanabilirsiniz.
```
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Gets the values of the boolean criteria and logs them. For example, if the
// boolean condition is whenNumberGreaterThan(10), then the logged value is 10.
const criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
console.log(criteriaValues);
```
Return

Object[]: Boole ölçüt türüne uygun bir bağımsız değişken dizisi. Parametrelerin sayısı ve türleri, FilterCriteriaBuilder sınıfının ilgili when...() yöntemiyle eşleşiyor.

`getHiddenValues()`

Filtrenin gizlediği değerleri döndürür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfalarında filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

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 sayfalarında filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the background color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

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 kalır.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfalarında filtrelerle kullanın. Bu yöntemi diğer filtre türleri için çağırırsanız null döndürür.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the foreground color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

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 pivot tablolardaki veritabanına bağlı olmayan filtreler için geçerlidir. Diğer filtre türleri için boş bir dizi döndürür.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its
// first filter.
const pivotTable = ss.getPivotTables()[0];
const pivotFilterValues =
    pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['Hello', 'World'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Parametreler

Ad	Tür	Açıklama
`values`	`String[]`	Gizlenecek değerlerin listesi.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

Atışlar

Error: Değerlerden herhangi biri null ise.

`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. Arka plan rengi filtresi ölçütü ayarlandığında mevcut renk filtresi ölçütleri bu oluşturucudan kaldırılı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();
const filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const criteria =
    SpreadsheetApp.newFilterCriteria().setVisibleBackgroundColor(color).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`visibleBackgroundColor`	`Color`	Ayarlanacak arka plan rengi. Renk, RGB tarzında 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 kalır. Ön plan rengi filtresi ölçütü ayarlandığında, mevcut renk filtresi ölçütleri bu oluşturucudan kaldırılı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();
const filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const criteria =
    SpreadsheetApp.newFilterCriteria().setVisibleForegroundColor(color).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`visibleForegroundColor`	`Color`	Ayarlanacak ön plan rengi. Renk, RGB tarzında 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çütü 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."
const pivotTable = ss.getPivotTables()[0];
const 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.

Atışlar

Error: Değerlerden herhangi biri null ise.

`whenCellEmpty()`

Filtre ölçütlerini boş hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenCellNotEmpty()`

Filtre ölçütlerini, boş olmayan hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenDateAfter(date)`

Belirtilen tarihten sonraki tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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 filtre uyguladığınız sütunun veri türünün tarih olması gerekmez ancak tarih değilse beklenmedik sonuçlar alabilirsiniz.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria = SpreadsheetApp.newFilterCriteria().whenDateAfter(date).build();
filter.setColumnFilterCriteria(1, criteria);

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 tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Enum RelativeDate bölümüne bakın.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

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 önceki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateBefore(date).build();
filter.setColumnFilterCriteria(1, criteria);

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 önceki tarihlere sahip hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Enum RelativeDate bölümüne bakın.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

Ad	Tür	Açıklama
`date`	`RelativeDate`	Gizlenecek en erken 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.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateEqualTo(date).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

Ad	Tür	Açıklama
`date`	`Date`	Hücre değerlerinin eşleşmesi gereken tarih.

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 Enum RelativeDate bölümüne bakın.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

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, belirtilen tarihlerden herhangi birine eşit tarihlere sahip hücreleri gösterecek şekilde ayarlar.

Bu ölçütü yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, bu ölçütleri bir DataSource sayfasında, veritabanına bağlı bir sayfada veya DataSource sayfasından oluşturulan bir pivot tablo olan DataSourcePivotTable'da filtrelerle kullanın.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

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.

Filtrelediğiniz sütunun veri türü tarih olmalıdır.

// Gets a pivot table that's connected to a database.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateNotEqualTo(date).build();
dataPivotTable.addFilter('date', criteria);

Parametreler

Ad	Tür	Açıklama
`date`	`Date`	Gizlenecek tarih.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenDateNotEqualToAny(dates)`

Filtre ölçütlerini, belirtilen tarihlerden hiçbirine eşit olmayan tarihlere sahip hücreleri gösterecek şekilde ayarlar.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateNotEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

Parametreler

Ad	Tür	Açıklama
`dates`	`Date[]`	Gizlenecek tarihler.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenFormulaSatisfied(formula)`

Filtre ölçütlerini, true değerine eşit olan belirli bir formülü (=B:B<C:C gibi) içeren 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();
const filter = ss.getFilter();
// Creates criteria that shows the rows where the value in column B is less than
// the value in column C and sets it to column A.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

Parametreler

Ad	Tür	Açıklama
`formula`	`String`	Giriş geçerliyse `true` olarak değerlendirilen özel formül.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenNumberBetween(start, end)`

Filtre ölçütlerini, belirtilen 2 sayı arasında olan veya bu sayılardan biri olan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri herhangi bir filtre türüyle 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();
const filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25,
// inclusively, and sets it to column A.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberBetween(1, 25).build();
filter.setColumnFilterCriteria(1, criteria);

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.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

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.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number
// 10, 20, or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

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ıya sahip hücreleri gösterecek şekilde ayarlar

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberGreaterThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

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 eşit sayıda hücreyi gösterecek şekilde ayarlar.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to
// column B.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberGreaterThanOrEqualTo(10)
                     .build();
filter.setColumnFilterCriteria(2, criteria);

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 az sayıda hücre içeren hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri herhangi bir filtre türüyle kullanabilirsiniz. Bu ölçütü 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();
const filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThan(10).build();
filter.setColumnFilterCriteria(2, criteria);

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 az veya eşit sayıda hücreyi gösterecek şekilde ayarlar.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThanOrEqualTo(10).build();
filter.setColumnFilterCriteria(2, criteria);

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ı arasında olmayan ve bu sayılardan hiçbiri olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25,
// inclusively, and sets it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotBetween(1, 25).build();
filter.setColumnFilterCriteria(2, criteria);

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.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column
// B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberNotEqualTo(25).build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`number`	`Number`	Gizlenecek numara.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenNumberNotEqualToAny(numbers)`

Filtre ölçütlerini, belirtilen sayılardan hiçbirine eşit olmayan bir sayıya sahip hücreleri gösterecek şekilde ayarlar.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20,
// or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberNotEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

Parametreler

Ad	Tür	Açıklama
`numbers`	`Number[]`	Gizlenecek numaralar.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`whenTextContains(text)`

Filtre ölçütlerini, belirtilen metni içeren metin içeren hücreleri gösterecek şekilde ayarlar. Metin büyük/küçük harfe duyarlı değildir.

Bu ölçütleri herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextContains('Northwest').build();
filter.setColumnFilterCriteria(2, criteria);

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 herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to
// column B.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextDoesNotContain('Northwest')
                     .build();
filter.setColumnFilterCriteria(2, criteria);

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 herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEndsWith('est').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`text`	`String`	Hücre metninin sonunun içermesi 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 herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it
// to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextEqualTo('hello').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`text`	`String`	Hücre metninin 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.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

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.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

Parametreler

Ad	Tür	Açıklama
`text`	`String`	Hücre metninin 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.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextNotEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

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 herhangi bir filtre türüyle kullanabilirsiniz.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets
// it to column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextStartsWith('pre').build();
filter.setColumnFilterCriteria(2, criteria);

Parametreler

Ad	Tür	Açıklama
`text`	`String`	Hücre metninin başlangıcında bulunması gereken metin.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.

`withCriteria(criteria, args)`

Filtre ölçütlerini, BooleanCriteria değerleriyle (ör. CELL_EMPTY veya NUMBER_GREATER_THAN) tanımlanan bir boole koşuluna ayarlar. Mevcut ölçütlerden mantıksal koşulu kopyalamak için mevcut ölçütlerde getCriteriaType() ve getCriteriaValues() kullanarak bu yöntemin parametrelerini tanımlayın.

Bu ölçütleri her tür filtreyle 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();
const filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to
// column C that has the same boolean conditions and additional criteria that
// hides the value, "Northwest."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Parametreler

Ad	Tür	Açıklama
`criteria`	`BooleanCriteria`	Boole ölçütünün türü.
`args`	`Object[]`	Ö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, yukarıdaki ilgili `when...()` yöntemleriyle eşleşir.

Return

FilterCriteriaBuilder: Zincirleme için bu oluşturucu.