Class FilterCriteriaBuilder

FilterCriteriaBuilder

Builder untuk kriteria filter. Untuk menambahkan kriteria ke filter, Anda harus melakukan hal berikut:

  1. Buat builder kriteria menggunakan SpreadsheetApp.newFilterCriteria().
  2. Tambahkan setelan ke builder menggunakan metode dari class ini.
  3. Gunakan build() untuk menyusun kriteria dengan setelan yang Anda tentukan.

Penggunaan umum

Menyembunyikan nilai di sheet

Contoh berikut mendapatkan filter yang ada di sheet dan menambahkan kriteria yang menyembunyikan sel di kolom C yang berisi "hello" atau "world". Kriteria dalam contoh ini hanya dapat digunakan dengan filter pada sheet Grid, jenis sheet default.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Hanya menampilkan sel yang tidak kosong

Contoh berikut menambahkan filter ke sheet DataSource, sheet yang terhubung ke database, dengan kriteria yang hanya menampilkan sel di kolom "Kategori" yang tidak kosong.
// 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);

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
build()FilterCriteriaMenggabungkan kriteria filter menggunakan setelan yang Anda tambahkan ke pembuat kriteria.
copy()FilterCriteriaBuilderMenyalin kriteria filter ini dan membuat pembuat kriteria yang dapat Anda terapkan ke filter lain.
getCriteriaType()BooleanCriteriaMenampilkan jenis boolean kriteria, misalnya, CELL_EMPTY.
getCriteriaValues()Object[]Menampilkan array argumen untuk kriteria boolean.
getHiddenValues()String[]Menampilkan nilai yang disembunyikan filter.
getVisibleBackgroundColor()ColorMenampilkan warna latar belakang yang digunakan sebagai kriteria filter.
getVisibleForegroundColor()ColorMenampilkan warna latar depan yang digunakan sebagai kriteria filter.
getVisibleValues()String[]Menampilkan nilai yang ditampilkan filter tabel pivot.
setHiddenValues(values)FilterCriteriaBuilderMenetapkan nilai yang akan disembunyikan.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderMenetapkan warna latar belakang yang digunakan sebagai kriteria filter.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderMenetapkan warna latar depan yang digunakan sebagai kriteria filter.
setVisibleValues(values)FilterCriteriaBuilderMenetapkan nilai yang akan ditampilkan di tabel pivot.
whenCellEmpty()FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel kosong.
whenCellNotEmpty()FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel yang tidak kosong.
whenDateAfter(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal setelah tanggal yang ditentukan.
whenDateAfter(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal setelah tanggal relatif yang ditentukan.
whenDateBefore(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal sebelum tanggal yang ditentukan.
whenDateBefore(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal sebelum tanggal relatif yang ditentukan.
whenDateEqualTo(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal yang ditentukan.
whenDateEqualTo(date)FilterCriteriaBuilderMenetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal relatif yang ditentukan.
whenDateEqualToAny(dates)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan tanggal yang sama dengan salah satu tanggal yang ditentukan.
whenDateNotEqualTo(date)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel yang tidak sama dengan tanggal yang ditentukan.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan tanggal yang tidak sama dengan tanggal yang ditentukan.
whenFormulaSatisfied(formula)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan formula yang ditentukan (seperti =B:B<C:C) yang dievaluasi menjadi true.
whenNumberBetween(start, end)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang berada di antara, atau merupakan salah satu dari, 2 angka yang ditentukan.
whenNumberEqualTo(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan angka yang ditentukan.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan salah satu angka yang ditentukan.
whenNumberGreaterThan(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari angka yang ditentukan
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar atau sama dengan angka yang ditentukan.
whenNumberLessThan(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang kurang dari angka yang ditentukan.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka kurang dari atau sama dengan angka yang ditentukan.
whenNumberNotBetween(start, end)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak berada di antara, dan bukan salah satu dari, 2 angka yang ditentukan.
whenNumberNotEqualTo(number)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.
whenTextContains(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang berisi teks yang ditentukan.
whenTextDoesNotContain(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak berisi teks yang ditentukan.
whenTextEndsWith(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang diakhiri dengan teks yang ditentukan.
whenTextEqualTo(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan teks yang ditentukan.
whenTextEqualToAny(texts)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan nilai teks yang ditentukan.
whenTextNotEqualTo(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan teks yang ditentukan.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan nilai yang ditentukan.
whenTextStartsWith(text)FilterCriteriaBuilderMenetapkan kriteria filter untuk menampilkan sel dengan teks yang dimulai dengan teks yang ditentukan.
withCriteria(criteria, args)FilterCriteriaBuilderMenetapkan kriteria filter ke kondisi boolean yang ditentukan oleh nilai BooleanCriteria, seperti CELL_EMPTY atau NUMBER_GREATER_THAN.

Dokumentasi mendetail

build()

Menggabungkan kriteria filter menggunakan setelan yang Anda tambahkan ke pembuat kriteria.

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

Pulang pergi

FilterCriteria — Representasi kriteria filter.


copy()

Menyalin kriteria filter ini dan membuat pembuat kriteria yang dapat Anda terapkan ke filter lain.

Anda dapat menggunakan metode ini dengan jenis filter apa pun. Jika menggunakan filter sheet, Anda dapat menyalin kriteria ke kolom lain.

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);

Pulang pergi

FilterCriteriaBuilder — Pembuat kriteria filter berdasarkan kriteria filter ini.


getCriteriaType()

Menampilkan jenis boolean kriteria, misalnya, CELL_EMPTY. Untuk mempelajari jenis kriteria boolean, lihat enum BooleanCriteria.

Orang sering menggunakan metode ini untuk menambahkan kriteria kondisi boolean ke filter tanpa mengganti kriteria yang ada.

Anda dapat menggunakan metode ini untuk jenis filter apa pun. Jika kriteria filter bukan kondisi boolean, tampilkan null.

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);

Pulang pergi

BooleanCriteria — Jenis kriteria boolean, atau null jika kriteria bukan kondisi boolean.


getCriteriaValues()

Menampilkan array argumen untuk kriteria boolean. Beberapa jenis kriteria boolean tidak memiliki argumen dan menampilkan array kosong, misalnya, CELL_NOT_EMPTY.

Orang sering menggunakan metode ini untuk menambahkan kriteria kondisi boolean ke filter tanpa mengganti kriteria yang ada.

  • Untuk mendapatkan jenis kriteria boolean, gunakan getCriteriaType().
  • Untuk menggunakan jenis kriteria dan nilai kriteria guna membuat atau mengubah kriteria filter, lihat withCriteria(criteria, args).

    Anda dapat menggunakan metode ini untuk jenis filter apa pun.

    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);

    Pulang pergi

    Object[] — Array argumen yang sesuai dengan jenis kriteria boolean. Jumlah argumen dan jenisnya cocok dengan metode when...() yang sesuai dari class FilterCriteriaBuilder.


getHiddenValues()

Menampilkan nilai yang disembunyikan filter.

Gunakan kriteria ini dengan filter pada sheet Grid, jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lainnya.

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);

Pulang pergi

String[] — Array nilai yang disembunyikan filter.


getVisibleBackgroundColor()

Menampilkan warna latar belakang yang digunakan sebagai kriteria filter. Sel dengan warna latar belakang ini tetap terlihat.

Gunakan kriteria ini dengan filter pada sheet Grid, jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lainnya.

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);

Pulang pergi

Color — Warna latar belakang yang digunakan sebagai kriteria filter.


getVisibleForegroundColor()

Menampilkan warna latar depan yang digunakan sebagai kriteria filter. Sel dengan warna latar depan ini tetap terlihat.

Gunakan kriteria ini dengan filter pada sheet Grid, jenis sheet default. Menampilkan null jika Anda memanggil metode ini untuk jenis filter lainnya.

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);

Pulang pergi

Color — Warna latar depan yang digunakan sebagai kriteria filter.


getVisibleValues()

Menampilkan nilai yang ditampilkan filter tabel pivot.

Kriteria ini hanya untuk filter pada tabel pivot yang tidak terhubung ke database. Menampilkan array kosong untuk jenis filter lainnya.

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);

Pulang pergi

String[] — Array nilai yang ditampilkan filter tabel pivot.


setHiddenValues(values)

Menetapkan nilai yang akan disembunyikan. Menghapus nilai yang terlihat atau disembunyikan yang ada.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, jenis sheet default.

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

Parameter

NamaJenisDeskripsi
valuesString[]Daftar nilai yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.

Menampilkan

Error — Jika salah satu nilainya adalah null.


setVisibleBackgroundColor(visibleBackgroundColor)

Menetapkan warna latar belakang yang digunakan sebagai kriteria filter. Sel dengan warna latar belakang ini tetap terlihat. Menetapkan kriteria filter warna latar belakang akan menghapus kriteria filter warna saat ini dari builder ini.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, jenis sheet default.

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

Parameter

NamaJenisDeskripsi
visibleBackgroundColorColorWarna latar belakang yang akan ditetapkan. Warna harus berupa warna gaya RGB. Metode ini tidak mendukung warna tema.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


setVisibleForegroundColor(visibleForegroundColor)

Menetapkan warna latar depan yang digunakan sebagai kriteria filter. Sel dengan warna latar depan ini tetap terlihat. Menetapkan kriteria filter warna latar depan akan menghapus kriteria filter warna saat ini dari builder ini.

Anda hanya dapat menggunakan kriteria ini untuk filter pada sheet Grid, jenis sheet default.

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

Parameter

NamaJenisDeskripsi
visibleForegroundColorColorWarna latar depan yang akan ditetapkan. Warna harus berupa warna gaya RGB. Metode ini tidak mendukung warna tema.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


setVisibleValues(values)

Menetapkan nilai yang akan ditampilkan di tabel pivot. Menghapus nilai yang terlihat atau disembunyikan yang ada.

Anda hanya dapat menggunakan kriteria ini untuk filter pada tabel pivot yang tidak terhubung ke database.

// Gets the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet and adds a filter to it that
// sets the visible values to "Northeast" and "Southwest."
const pivotTable = ss.getPivotTables()[0];
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setVisibleValues(['Northeast', 'Southwest'])
                     .build();
pivotTable.addFilter(2, criteria);

Parameter

NamaJenisDeskripsi
valuesString[]Daftar nilai yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.

Menampilkan

Error — Jika salah satu nilainya adalah null.


whenCellEmpty()

Menetapkan kriteria filter untuk menampilkan sel kosong.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenCellNotEmpty()

Menetapkan kriteria filter untuk menampilkan sel yang tidak kosong.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateAfter(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal setelah tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateDateTanggal terbaru yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateAfter(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal setelah tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateRelativeDateTanggal relatif terbaru.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateBefore(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal sebelum tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateDateTanggal paling awal yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateBefore(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal sebelum tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateRelativeDateTanggal relatif paling awal yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateEqualTo(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda filter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateDateTanggal yang harus cocok dengan nilai sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateEqualTo(date)

Menetapkan kriteria filter yang menampilkan sel dengan tanggal yang sama dengan tanggal relatif yang ditentukan. Untuk melihat opsi tanggal relatif, lihat Enum RelativeDate.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa tanggal, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
dateRelativeDateTanggal relatif yang harus cocok dengan nilai sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateEqualToAny(dates)

Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang sama dengan salah satu tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
datesDate[]Tanggal yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateNotEqualTo(date)

Menetapkan kriteria filter untuk menampilkan sel yang tidak sama dengan tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

Jenis data kolom yang Anda gunakan untuk memfilter harus berupa tanggal.

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

Parameter

NamaJenisDeskripsi
dateDateTanggal yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenDateNotEqualToAny(dates)

Menetapkan kriteria filter untuk menampilkan sel dengan tanggal yang tidak sama dengan tanggal yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
datesDate[]Tanggal yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenFormulaSatisfied(formula)

Menetapkan kriteria filter untuk menampilkan sel dengan formula yang ditentukan (seperti =B:B<C:C) yang dievaluasi menjadi true.

Anda hanya dapat menggunakan kriteria ini untuk memfilter data yang tidak terhubung ke database.

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

Parameter

NamaJenisDeskripsi
formulaStringFormula kustom yang dievaluasi ke true jika input valid.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberBetween(start, end)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang berada di antara, atau merupakan salah satu dari, 2 angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
startNumberAngka terendah yang akan ditampilkan.
endNumberAngka tertinggi yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberAngka yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberEqualToAny(numbers)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang sama dengan salah satu angka yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
numbersNumber[]Angka yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberGreaterThan(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar dari angka yang ditentukan

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberAngka tertinggi yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberGreaterThanOrEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang lebih besar atau sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberAngka terendah yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberLessThan(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang kurang dari angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberAngka terendah yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberLessThanOrEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka kurang dari atau sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberAngka tertinggi yang akan ditampilkan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberNotBetween(start, end)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak berada di antara, dan bukan salah satu dari, 2 angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
startNumberAngka terendah disembunyikan.
endNumberAngka tertinggi yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberNotEqualTo(number)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun. Jika Anda menggunakan kriteria ini dengan data yang terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter harus berupa angka. Jika data tidak terhubung ke database, jenis data kolom yang Anda gunakan untuk memfilter tidak harus berupa angka, tetapi jika tidak, Anda mungkin mendapatkan hasil yang tidak terduga.

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

Parameter

NamaJenisDeskripsi
numberNumberNomor yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenNumberNotEqualToAny(numbers)

Menetapkan kriteria filter untuk menampilkan sel dengan angka yang tidak sama dengan angka yang ditentukan.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
numbersNumber[]Angka yang akan disembunyikan.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextContains(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang berisi teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang harus ada dalam sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextDoesNotContain(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak berisi teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang tidak boleh ada di sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextEndsWith(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang diakhiri dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang harus ada di akhir teks sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextEqualTo(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang harus sama dengan teks sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextEqualToAny(texts)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang sama dengan nilai teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
textsString[]Nilai teks yang harus sama dengan sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextNotEqualTo(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang tidak boleh sama dengan teks sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextNotEqualToAny(texts)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang tidak sama dengan nilai yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda hanya dapat menggunakan kriteria ini dengan data yang terhubung ke database. Misalnya, gunakan kriteria ini dengan filter pada sheet DataSource, sheet yang terhubung ke database, atau DataSourcePivotTable, tabel pivot yang dibuat dari sheet DataSource.

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

Parameter

NamaJenisDeskripsi
textsString[]Nilai teks yang tidak boleh sama dengan sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


whenTextStartsWith(text)

Menetapkan kriteria filter untuk menampilkan sel dengan teks yang dimulai dengan teks yang ditentukan. Teks tidak peka huruf besar/kecil.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun.

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

Parameter

NamaJenisDeskripsi
textStringTeks yang harus diawali teks sel.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.


withCriteria(criteria, args)

Menetapkan kriteria filter ke kondisi boolean yang ditentukan oleh nilai BooleanCriteria, seperti CELL_EMPTY atau NUMBER_GREATER_THAN. Untuk menyalin kondisi boolean dari kriteria yang ada, tentukan parameter untuk metode ini menggunakan getCriteriaType() dan getCriteriaValues() pada kriteria yang ada.

Anda dapat menggunakan kriteria ini dengan jenis filter apa pun, tetapi beberapa BooleanCriteria tidak berlaku untuk semua filter.

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

Parameter

NamaJenisDeskripsi
criteriaBooleanCriteriaJenis kriteria boolean.
argsObject[]Array argumen yang sesuai dengan jenis kriteria; jumlah argumen dan jenisnya cocok dengan metode when...() yang sesuai di atas.

Pulang pergi

FilterCriteriaBuilder — Builder ini, untuk pembuatan rantai.