Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

  1. SpreadsheetApp.newFilterCriteria() kullanarak ölçüt oluşturucuyu oluşturun.
  2. Bu sınıftaki yöntemleri kullanarak ayarları oluşturucuya ekleyin.
  3. Ölçütleri belirlediğiniz ayarlarla birleştirmek için build() öğesini kullanın.

Yaygın kullanım alanları

Sayfada değerleri gizleme

Aşağıdaki örnek, bir sayfanın mevcut filtresini alır ve hücreleri gizleyen ölçütler ekler. "merhaba" içeren C sütunu veya "dünya". Bu örnekteki ölçütler yalnızca Grid sayfadaki filtreler, varsayılan sayfa türü olan sayfa türüdür.
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, DataSource sayfasına filtre ekler. Bu sayfa bir veritabanına bağlı (yalnızca "Kategori"deki hücreleri gösteren ölçütlerle) sütun bu bağlantılar boş değildir.
// 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öntemDönüş türüKısa açıklama
build()FilterCriteriaÖlçüt oluşturucuya eklediğiniz ayarları kullanarak filtre ölçütlerini oluşturur.
copy()FilterCriteriaBuilderBu filtre ölçütlerini kopyalar ve başka bir filtreye uygulayabileceğiniz bir ölçüt oluşturucu oluşturur filtresini uygulayabilirsiniz.
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()ColorFiltre ölçütü olarak kullanılan arka plan rengini döndürür.
getVisibleForegroundColor()ColorFiltre ö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)FilterCriteriaBuilderGizlenecek değerleri ayarlar.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderFiltre ölçütü olarak kullanılan arka plan rengini ayarlar.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderFiltre ölçütü olarak kullanılan ön plan rengini ayarlar.
setVisibleValues(values)FilterCriteriaBuilderPivot tabloda gösterilecek değerleri ayarlar.
whenCellEmpty()FilterCriteriaBuilderFiltre ölçütlerini boş hücreleri gösterecek şekilde ayarlar.
whenCellNotEmpty()FilterCriteriaBuilderFiltre ölçütlerini boş olmayan hücreleri gösterecek şekilde ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateAfter(date)FilterCriteriaBuilderBelirtilen göreli tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateBefore(date)FilterCriteriaBuilderBelirtilen göreli tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen tarihe eşit tarihleri olan hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualTo(date)FilterCriteriaBuilderBelirtilen göreli tarihe eşit tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar.
whenDateEqualToAny(dates)FilterCriteriaBuilderFiltre ölçütlerini, tarihleri belirtilen tarihlerden herhangi birine eşit olan hücreleri gösterecek şekilde ayarlar.
whenDateNotEqualTo(date)FilterCriteriaBuilderFiltre ölçütlerini belirtilen tarihe eşit olmayan hücreleri gösterecek şekilde ayarlar.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderFiltre ölçütlerini, tarihleri belirtilenlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar .
whenFormulaSatisfied(formula)FilterCriteriaBuilderFiltre ölçütlerini, şunu içeren belirtilen bir formüle (ör. =B:B<C:C) sahip hücreleri gösterecek şekilde ayarlar true olarak değerlendirilir.
whenNumberBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, 2 arasında bir sayı olan veya 2'den birinin arasında olan hücreleri gösterecek şekilde ayarlar belirtir.
whenNumberEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilenlerden herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.
whenNumberGreaterThan(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan büyük olan hücreleri gösterecek şekilde ayarlar
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilenden büyük veya bu değere eşit olan hücreleri gösterecek şekilde ayarlar sayı.
whenNumberLessThan(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıdan küçük bir sayıya sahip hücreleri gösterecek şekilde ayarlar.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilenden küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar sayı.
whenNumberNotBetween(start, end)FilterCriteriaBuilderFiltre ölçütlerini, 2 sayısının arasında ve iki değerden biri olmayan hücreleri gösterecek şekilde ayarlar belirtir.
whenNumberNotEqualTo(number)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen sayıya eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderFiltre ölçütlerini, belirtilenlerin herhangi birine eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.
whenTextContains(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içeren metni içeren hücreleri gösterecek şekilde ayarlar.
whenTextDoesNotContain(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metni içermeyen metni içeren hücreleri gösterecek şekilde ayarlar.
whenTextEndsWith(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metinle biten metinlere sahip hücreleri gösterecek şekilde ayarlar.
whenTextEqualTo(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metne eşit olan hücrelerin gösterileceği şekilde ayarlar.
whenTextEqualToAny(texts)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metnin herhangi birine eşit bir metin içeren hücreleri gösterecek şekilde ayarlar değerler.
whenTextNotEqualTo(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metne eşit olmayan bir metin içeren hücreleri gösterecek şekilde ayarlar.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metinlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar değerler.
whenTextStartsWith(text)FilterCriteriaBuilderFiltre ölçütlerini, belirtilen metinle başlayan metin içeren hücreleri gösterecek şekilde ayarlar.
withCriteria(criteria, args)FilterCriteriaBuilderFiltre ölçütlerini BooleanCriteria değerleriyle tanımlanan bir boole koşuluna ayarlar. Örneğin, CELL_EMPTY veya NUMBER_GREATER_THAN olarak.

Ayrıntılı belgeler

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();
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çütlerinin temsili.


copy()

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

Bu yöntemi tüm filtre türleriyle kullanabilirsiniz. Sayfa filtresi kullanıyorsanız şunları yapabilirsiniz: ölçütleri başka bir sütuna kopyalayın.

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çütlerin boole türünü döndürür (ör. CELL_EMPTY). Türler hakkında bilgi edinmek için Boole ölçütleri için BooleanCriteria sıralamasına bakın.

Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.

  • Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() işlevini kullanın.
  • Filtre ölçütleri oluşturmak veya mevcut filtreleri değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın: withCriteria(criteria, args)

Bu yöntemi tüm filtre türleri için kullanabilirsiniz. Filtre ölçütleri bir boole değeri değilse koşul, 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çütlerinin türü veya ölçütler bir boole değilse null koşul.


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şkenlerini içerir ve boş bir dizi döndürür (örneğin, CELL_NOT_EMPTY).

Kullanıcılar genellikle boole koşulu ölçütlerini değiştirmeden bir filtreye eklemek için bu yöntemi kullanır yardımcı olur.

  • Boole ölçüt türünü almak için getCriteriaType() işlevini kullanın.
  • Filtre ölçütleri oluşturmak veya mevcut bir filtre ölçütünü değiştirmek üzere ölçüt türünü ve ölçüt değerlerini kullanmak için şu sayfaya bakın: withCriteria(criteria, args)

    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şken sayısı ve türü, FilterCriteriaBuilder sınıfının ilgili when...() yöntemiyle eşleşmelidir.


getHiddenValues()

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

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için ç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 kalır görünür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için ç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. Ön plan rengi bu renkte olan hücreler kaldı görünür.

Bu ölçütleri, varsayılan sayfa türü olan Grid sayfadaki filtrelerle kullanın. Bu yöntemi diğer filtre türleri için ç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 değerler dizisi.


setHiddenValues(values)

Gizlenecek değerleri ayarlar. Görünür veya gizli tüm değerleri temizler.

Bu ölçütü yalnızca varsayılan olarak Grid sayfadaki filtreler için kullanabilirsiniz sayfa türü.

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

AdTürAçıklama
valuesString[]Gizlenecek değerlerin listesi.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.

Fırlatma

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 kalır görünür. Arka plan rengi filtresi ölçütü ayarladığınızda mevcut renk filtresi ölçütleri kaldırılır kullanabilirsiniz.

Bu ölçütü yalnızca varsayılan olarak Grid sayfadaki filtreler için kullanabilirsiniz sayfa türü.

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

AdTürAçıklama
visibleBackgroundColorColorAyarlanacak arka plan rengi. Renk RGB stilinde olmalıdır rengi. 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. Ön plan rengi bu renkte olan hücreler kaldı görünür. Ön plan rengi filtresi ölçütü ayarladığınızda mevcut renk filtresi ölçütleri kaldırılır kullanabilirsiniz.

Bu ölçütü yalnızca varsayılan olarak Grid sayfadaki filtreler için kullanabilirsiniz sayfa türü.

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

AdTürAçıklama
visibleForegroundColorColorAyarlanacak ön plan rengi. Renk RGB stilinde olmalıdır rengi. Bu yöntem, tema renklerini desteklemez.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


setVisibleValues(values)

Pivot tabloda gösterilecek değerleri ayarlar. Görünür veya gizli tüm değerleri temizler.

Bu ölçütleri yalnızca

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

AdTürAçıklama
valuesString[]Gösterilecek değerlerin listesi.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.

Fırlatma

Error — Değerlerden herhangi biri null ise.


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

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateDateGizlenecek en son tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateAfter(date)

Belirtilen göreli tarihten sonra olan hücreleri gösteren filtre ölçütlerini ayarlar. Alıcı: göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate bölümüne bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateRelativeDateEn son göreli tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateBefore(date)

Belirtilen tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateDateGizlenecek en erken tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateBefore(date)

Belirtilen göreli tarihten önce olan hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate bölümüne bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateRelativeDateGizlenecek en erken göreli tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateEqualTo(date)

Belirtilen tarihe eşit tarihleri olan hücreleri gösteren filtre ölçütlerini ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateDateHücre değerlerinin eşleşmesi gereken tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateEqualTo(date)

Belirtilen göreli tarihe eşit tarihleri içeren hücreleri gösteren filtre ölçütlerini ayarlar. Göreli tarih seçeneklerini görüntülemek için Sıralama RelativeDate bölümüne bakın.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir tarih olmalıdır. Öğe veri bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir tarih olması gerekir, ancak değilse beklenmedik 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

AdTürAçıklama
dateRelativeDateHü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, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
datesDate[]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, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

Filtrelemede temel aldığı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

AdTürAçıklama
dateDateGizlenecek tarih.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenDateNotEqualToAny(dates)

Filtre ölçütlerini, tarihleri belirtilenlerin 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, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
datesDate[]Gizlenecek tarihler.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenFormulaSatisfied(formula)

Filtre ölçütlerini, şunu içeren belirtilen bir formüle (ör. =B:B<C:C) sahip hücreleri gösterecek şekilde ayarlar true olarak değerlendirilir.

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

AdTürAçıklama
formulaStringGiriş geçerliyse true sonucunu veren özel formül.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberBetween(start, end)

Filtre ölçütlerini, 2 arasında bir sayı olan veya 2'den biri olan hücreleri gösterecek şekilde ayarlar belirtir.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
startNumberGösterilecek en düşük sayı.
endNumberGö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 filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGösterilecek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberEqualToAny(numbers)

Filtre ölçütlerini, belirtilenlerden herhangi birine eşit bir sayıya sahip hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
numbersNumber[]Gösterilecek sayılar.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberGreaterThan(number)

Filtre ölçütlerini, belirtilen sayıdan büyük olan hücreleri gösterecek şekilde ayarlar

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGizlenecek en yüksek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberGreaterThanOrEqualTo(number)

Filtre ölçütlerini, belirtilenden büyük veya bu değere eşit olan hücreleri gösterecek şekilde ayarlar sayı.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGö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 filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGizlenecek en düşük sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberLessThanOrEqualTo(number)

Filtre ölçütlerini, belirtilenden küçük veya ona eşit olan hücreleri gösterecek şekilde ayarlar sayı.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGösterilecek en yüksek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberNotBetween(start, end)

Filtre ölçütlerini, 2 sayısının arasında ve iki değerden biri olmayan hücreleri gösterecek şekilde ayarlar belirtir.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü bir sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
startNumberEn küçük sayıyı gizler.
endNumberGizlenecek 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ı içeren hücreleri gösterecek şekilde ayarlar.

Bu ölçütleri tüm filtre türleriyle kullanabilirsiniz. Bu ölçütleri filtre uygulamak için kullandığınız sütunun veri türü sayı olmalıdır. Eğer veriler bir veritabanına bağlı değilse, filtre uyguladığınız sütunun veri türü bir sayı olması gerekir, ancak 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

AdTürAçıklama
numberNumberGizlenecek sayı.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenNumberNotEqualToAny(numbers)

Filtre ölçütlerini, belirtilenlerin herhangi birine eşit olmayan bir sayı içeren hücreleri gösterecek şekilde ayarlar numaraları'na dokunun.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
numbersNumber[]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

AdTürAçıklama
textStringHücrede bulunması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextDoesNotContain(text)

Filtre ölçütlerini, belirtilen metni içermeyen metni içeren hücreleri gösterecek şekilde ayarlar. İlgili içeriği oluşturmak için kullanılan 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

AdTürAçıklama
textStringHücrede içermemesi gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEndsWith(text)

Filtre ölçütlerini, belirtilen metinle biten metinlere sahip 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

AdTürAçıklama
textStringHücre metninin sonunda yer alması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEqualTo(text)

Filtre ölçütlerini, belirtilen metne eşit olan hücrelerin gösterileceği ş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

AdTürAçıklama
textStringHücre metninin eşit olması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextEqualToAny(texts)

Filtre ölçütlerini, belirtilen metnin herhangi birine eşit bir metin içeren hücreleri gösterecek şekilde ayarlar değerler. Metin, büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
textsString[]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 bir metin içeren hücreleri gösterecek şekilde ayarlar. İlgili içeriği oluşturmak için kullanılan metin büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
textStringHücre metninin eşit olamayacağı metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


whenTextNotEqualToAny(texts)

Filtre ölçütlerini, belirtilen metinlerin hiçbirine eşit olmayan hücreleri gösterecek şekilde ayarlar değerler. Metin, büyük/küçük harfe duyarlı değildir.

Bu ölçütleri yalnızca bir veritabanına bağlı verilerle kullanabilirsiniz. Örneğin, şunu kullanın: filtresi uygulanmış bir sayfadır. DataSource sayfasında, veritabanı veya DataSourcePivotTable, DataSource sayfasından oluşturulmuş bir pivot tablodur.

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

AdTürAçıklama
textsString[]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

AdTürAçıklama
textStringHücre metninin başında yer alması gereken metin.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.


withCriteria(criteria, args)

Filtre ölçütlerini BooleanCriteria değerleriyle tanımlanan bir boole koşuluna ayarlar. Örneğin, CELL_EMPTY veya NUMBER_GREATER_THAN olarak. Boole koşulunu şuradan kopyalamak için: Mevcut ölçütlere göre, bir uygulamada getCriteriaType() ve getCriteriaValues() kullanarak bu yöntemin parametrelerini tanımlayın. yardımcı olur.

Bu ölçütleri herhangi bir filtre türünde kullanabilirsiniz ancak bazı BooleanCriteria türleri kullanılamaz tüm filtreler için geçerlidir.

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

AdTürAçıklama
criteriaBooleanCriteriaBoole ölçütlerinin türü.
argsObject[]Ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişken sayısını türleri yukarıdaki karşılık gelen when...() yöntemleriyle eşleşmelidir.

Return

FilterCriteriaBuilder — Zincirleme için bu oluşturucu.