Class FilterCriteriaBuilder

ตัวสร้างเกณฑ์ตัวกรอง

ตัวสร้างเกณฑ์การกรอง หากต้องการเพิ่มเกณฑ์ลงในตัวกรอง คุณต้องทําดังนี้

  1. สร้างเครื่องมือสร้างเกณฑ์โดยใช้ SpreadsheetApp.newFilterCriteria()
  2. เพิ่มการตั้งค่าลงในเครื่องมือสร้างโดยใช้เมธอดจากคลาสนี้
  3. ใช้ build() เพื่อรวบรวมเกณฑ์ตามการตั้งค่าที่ระบุ

การใช้งานทั่วไป

ซ่อนค่าในชีต

ตัวอย่างต่อไปนี้จะรับตัวกรองที่มีอยู่ของชีตและเพิ่มเกณฑ์ที่จะซ่อนเซลล์ในคอลัมน์ C ที่มี "hello" หรือ "world" เกณฑ์ในตัวอย่างนี้ใช้ได้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้นเท่านั้น 
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

แสดงเฉพาะเซลล์ที่ไม่ใช่ค่าว่าง

ตัวอย่างต่อไปนี้จะเพิ่มตัวกรองลงในชีต DataSource ซึ่งเป็นชีตที่เชื่อมต่อกับฐานข้อมูล โดยมีเกณฑ์ที่แสดงเฉพาะเซลล์ในคอลัมน์ "หมวดหมู่" ที่ไม่ได้ว่างเปล่า 
// 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);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()FilterCriteriaรวบรวมเกณฑ์ตัวกรองโดยใช้การตั้งค่าที่คุณเพิ่มลงในเครื่องมือสร้างเกณฑ์
copy()FilterCriteriaBuilderคัดลอกเกณฑ์ตัวกรองนี้และสร้างเครื่องมือสร้างเกณฑ์ที่คุณนำไปใช้กับตัวกรองอื่นได้
getCriteriaType()BooleanCriteriaแสดงผลประเภทบูลีนของเกณฑ์ เช่น CELL_EMPTY
getCriteriaValues()Object[]แสดงผลอาร์เรย์ของอาร์กิวเมนต์สําหรับเกณฑ์บูลีน
getHiddenValues()String[]แสดงผลค่าที่ตัวกรองซ่อนอยู่
getVisibleBackgroundColor()Colorส่งกลับสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง
getVisibleForegroundColor()Colorแสดงผลสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง
getVisibleValues()String[]แสดงผลค่าที่ตัวกรองตาราง Pivot แสดง
setHiddenValues(values)FilterCriteriaBuilderตั้งค่าที่จะซ่อน
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderตั้งค่าสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderตั้งค่าสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง
setVisibleValues(values)FilterCriteriaBuilderตั้งค่าที่จะแสดงในตาราง Pivot
whenCellEmpty()FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ว่าง
whenCellNotEmpty()FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่ใช่ค่าว่าง
whenDateAfter(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่อยู่หลังวันที่ที่ระบุ
whenDateAfter(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่อยู่หลังวันที่ที่เกี่ยวข้องที่ระบุ
whenDateBefore(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่ก่อนวันที่ที่ระบุ
whenDateBefore(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่ก่อนวันที่ที่เกี่ยวข้องที่ระบุ
whenDateEqualTo(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่เท่ากับวันที่ที่ระบุ
whenDateEqualTo(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่เท่ากับวันที่สัมพัทธ์ที่ระบุ
whenDateEqualToAny(dates)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีวันที่เท่ากับวันที่ที่ระบุ
whenDateNotEqualTo(date)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่เท่ากับวันที่ที่ระบุ
whenDateNotEqualToAny(dates)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีวันที่ไม่เท่ากับวันที่ที่ระบุ
whenFormulaSatisfied(formula)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีสูตรที่ระบุ (เช่น =B:B<C:C) ซึ่งประเมินเป็น true
whenNumberBetween(start, end)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขอยู่ระหว่างหรือเท่ากับตัวเลขที่ระบุ 2 รายการ
whenNumberEqualTo(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขเท่ากับตัวเลขที่ระบุ
whenNumberEqualToAny(numbers)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขเท่ากับตัวเลขที่ระบุ
whenNumberGreaterThan(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขมากกว่าตัวเลขที่ระบุ
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขมากกว่าหรือเท่ากับตัวเลขที่ระบุ
whenNumberLessThan(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขน้อยกว่าที่ระบุ
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขน้อยกว่าหรือเท่ากับตัวเลขที่ระบุ
whenNumberNotBetween(start, end)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่อยู่ในช่วงและไม่ตรงกับตัวเลข 2 รายการที่ระบุ
whenNumberNotEqualTo(number)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่เท่ากับตัวเลขที่ระบุ
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่เท่ากับตัวเลขที่ระบุ
whenTextContains(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งมีข้อความที่ระบุ
whenTextDoesNotContain(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่มีข้อความที่ระบุ
whenTextEndsWith(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ลงท้ายด้วยข้อความที่ระบุ
whenTextEqualTo(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ
whenTextEqualToAny(texts)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับค่าข้อความที่ระบุ
whenTextNotEqualTo(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความไม่เท่ากับข้อความที่ระบุ
whenTextNotEqualToAny(texts)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความไม่เท่ากับค่าที่ระบุ
whenTextStartsWith(text)FilterCriteriaBuilderตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ขึ้นต้นด้วยข้อความที่ระบุ
withCriteria(criteria, args)FilterCriteriaBuilderตั้งค่าเกณฑ์การกรองเป็นเงื่อนไขบูลีนที่กําหนดโดยค่า BooleanCriteria เช่น CELL_EMPTY หรือ NUMBER_GREATER_THAN

เอกสารประกอบโดยละเอียด

build()

รวบรวมเกณฑ์ตัวกรองโดยใช้การตั้งค่าที่คุณเพิ่มลงในเครื่องมือสร้างเกณฑ์ 

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

รีเทิร์น

FilterCriteria — การนําเสนอเกณฑ์ตัวกรอง

copy()

คัดลอกเกณฑ์ตัวกรองนี้และสร้างเครื่องมือสร้างเกณฑ์ที่คุณนำไปใช้กับตัวกรองอื่นได้

คุณใช้เมธอดนี้กับตัวกรองประเภทใดก็ได้ หากใช้ตัวกรองชีต คุณสามารถคัดลอกเกณฑ์ไปยังคอลัมน์อื่นได้ 

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

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างเกณฑ์ตัวกรองตามเกณฑ์ตัวกรองนี้

getCriteriaType()

แสดงผลประเภทบูลีนของเกณฑ์ เช่น CELL_EMPTY ดูข้อมูลเกี่ยวกับประเภทของเกณฑ์บูลีนได้ที่ BooleanCriteria enum

ผู้ใช้มักใช้วิธีนี้เพื่อเพิ่มเกณฑ์เงื่อนไขบูลีนลงในตัวกรองโดยไม่แทนที่เกณฑ์ที่มีอยู่

  • หากต้องการรับอาร์กิวเมนต์สําหรับเกณฑ์ ให้ใช้ getCriteriaValues()
  • หากต้องการใช้ประเภทเกณฑ์และค่าเกณฑ์เพื่อสร้างหรือแก้ไขเกณฑ์ตัวกรอง โปรดดู withCriteria(criteria, args)

คุณใช้วิธีการนี้กับตัวกรองประเภทใดก็ได้ หากเกณฑ์ตัวกรองไม่ใช่เงื่อนไขบูลีน ระบบจะแสดงผล 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);

รีเทิร์น

BooleanCriteria — ประเภทของเกณฑ์บูลีน หรือ null หากเกณฑ์ไม่ใช่เงื่อนไขบูลีน

getCriteriaValues()

แสดงผลอาร์เรย์ของอาร์กิวเมนต์สําหรับเกณฑ์บูลีน เกณฑ์บูลีนบางประเภทไม่มีอาร์กิวเมนต์และแสดงผลอาร์เรย์ว่าง เช่น CELL_NOT_EMPTY

ผู้ใช้มักใช้วิธีนี้เพื่อเพิ่มเกณฑ์เงื่อนไขบูลีนลงในตัวกรองโดยไม่แทนที่เกณฑ์ที่มีอยู่

  • หากต้องการรับประเภทเกณฑ์บูลีน ให้ใช้ getCriteriaType()
  • หากต้องการใช้ประเภทเกณฑ์และค่าเกณฑ์เพื่อสร้างหรือแก้ไขเกณฑ์ตัวกรอง โปรดดู withCriteria(criteria, args)

    คุณใช้วิธีการนี้กับตัวกรองประเภทใดก็ได้ 

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

    รีเทิร์น

    Object[] — อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์บูลีน จํานวนอาร์กิวเมนต์และประเภทของอาร์กิวเมนต์ตรงกับเมธอด when...() ที่เกี่ยวข้องของคลาส FilterCriteriaBuilder

getHiddenValues()

แสดงผลค่าที่ตัวกรองซ่อนอยู่

ใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้น แสดงผล null หากคุณเรียกใช้เมธอดนี้กับตัวกรองประเภทอื่นๆ 

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

รีเทิร์น

String[] — อาร์เรย์ของค่าที่ตัวกรองซ่อนไว้

getVisibleBackgroundColor()

ส่งกลับสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหลังนี้จะยังคงมองเห็นได้

ใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้น แสดงผล null หากคุณเรียกใช้เมธอดนี้กับตัวกรองประเภทอื่นๆ 

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

รีเทิร์น

Color — สีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง

getVisibleForegroundColor()

แสดงผลสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหน้านี้จะยังคงมองเห็นได้

ใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้น แสดงผล null หากคุณเรียกใช้เมธอดนี้กับตัวกรองประเภทอื่นๆ 

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

รีเทิร์น

Color — สีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง

getVisibleValues()

แสดงผลค่าที่ตัวกรองตาราง Pivot แสดง

เกณฑ์นี้มีไว้สำหรับตัวกรองในตาราง Pivot ที่ไม่ได้เชื่อมต่อกับฐานข้อมูลเท่านั้น แสดงผลอาร์เรย์ว่างสำหรับตัวกรองประเภทอื่นๆ 

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

รีเทิร์น

String[] — อาร์เรย์ของค่าที่ตัวกรองตาราง Pivot แสดง

setHiddenValues(values)

ตั้งค่าที่จะซ่อน ล้างค่าที่มองเห็นหรือซ่อนอยู่ที่มีอยู่

คุณใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้นได้เท่านั้น 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]รายการค่าที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

โยน

Error — หากค่าใดมีค่าเป็น null

setVisibleBackgroundColor(visibleBackgroundColor)

ตั้งค่าสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหลังนี้จะยังคงมองเห็นได้ การตั้งค่าเกณฑ์ตัวกรองสีพื้นหลังจะนำเกณฑ์ตัวกรองสีปัจจุบันออกจากเครื่องมือสร้างนี้

คุณใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้นได้เท่านั้น 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibleBackgroundColorColorสีพื้นหลังที่จะตั้งค่า สีต้องเป็นสีสไตล์ RGB วิธีนี้ไม่รองรับสีของธีม

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

setVisibleForegroundColor(visibleForegroundColor)

ตั้งค่าสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหน้านี้จะยังคงมองเห็นได้ การตั้งค่าเกณฑ์ตัวกรองสีพื้นหน้าจะนำเกณฑ์ตัวกรองสีปัจจุบันออกจากเครื่องมือสร้างนี้

คุณใช้เกณฑ์นี้กับตัวกรองในชีต Grid ซึ่งเป็นชีตประเภทเริ่มต้นได้เท่านั้น 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibleForegroundColorColorสีพื้นหน้าที่จะตั้งค่า สีต้องเป็นสีสไตล์ RGB วิธีนี้ไม่รองรับสีของธีม

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

setVisibleValues(values)

ตั้งค่าที่จะแสดงในตาราง Pivot ล้างค่าที่มองเห็นหรือซ่อนอยู่ที่มีอยู่

คุณใช้เกณฑ์นี้ได้กับตัวกรองในตาราง Pivot ที่ไม่ได้เชื่อมต่อกับฐานข้อมูลเท่านั้น 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]รายการค่าที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

โยน

Error — หากค่าใดมีค่าเป็น null

whenCellEmpty()

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ว่าง

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenCellNotEmpty()

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่ใช่ค่าว่าง

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateAfter(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่อยู่หลังวันที่ที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ล่าสุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateAfter(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่อยู่หลังวันที่ที่เกี่ยวข้องที่ระบุ หากต้องการดูตัวเลือกวันที่แบบสัมพัทธ์ โปรดดู Enum RelativeDate

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่สัมพัทธ์ล่าสุด

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateBefore(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่ก่อนวันที่ที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่แรกสุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateBefore(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่ก่อนวันที่ที่เกี่ยวข้องที่ระบุ หากต้องการดูตัวเลือกวันที่แบบสัมพัทธ์ โปรดดู Enum RelativeDate

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ที่เกี่ยวข้องที่เก่าที่สุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateEqualTo(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่เท่ากับวันที่ที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่ค่าของเซลล์ต้องตรงกัน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateEqualTo(date)

ตั้งค่าเกณฑ์ตัวกรองที่แสดงเซลล์ที่มีวันที่เท่ากับวันที่สัมพัทธ์ที่ระบุ หากต้องการดูตัวเลือกวันที่แบบสัมพัทธ์ โปรดดู Enum RelativeDate

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่แบบสัมพัทธ์ที่ค่าของเซลล์ต้องตรงกัน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateEqualToAny(dates)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีวันที่เท่ากับวันที่ที่ระบุ

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
datesDate[]วันที่ที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateNotEqualTo(date)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่เท่ากับวันที่ที่ระบุ

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต DataSource

ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นวันที่ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenDateNotEqualToAny(dates)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีวันที่ไม่เท่ากับวันที่ที่ระบุ

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
datesDate[]วันที่ที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenFormulaSatisfied(formula)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีสูตรที่ระบุ (เช่น =B:B<C:C) ซึ่งประเมินเป็น true

คุณใช้เกณฑ์นี้เพื่อกรองข้อมูลที่ไม่ได้เชื่อมต่อกับฐานข้อมูลได้เท่านั้น 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรที่กําหนดเองซึ่งประเมินเป็น true หากอินพุตถูกต้อง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberBetween(start, end)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขอยู่ระหว่างหรือเท่ากับตัวเลขที่ระบุ 2 รายการ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberตัวเลขต่ำสุดที่จะแสดง
endNumberจำนวนสูงสุดที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberEqualTo(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขเท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberตัวเลขที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberEqualToAny(numbers)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขเท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numbersNumber[]ตัวเลขที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberGreaterThan(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขมากกว่าตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนสูงสุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberGreaterThanOrEqualTo(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขมากกว่าหรือเท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberตัวเลขต่ำสุดที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberLessThan(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขน้อยกว่าที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนต่ำสุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberLessThanOrEqualTo(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขน้อยกว่าหรือเท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนสูงสุดที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberNotBetween(start, end)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่อยู่ในช่วงและไม่ตรงกับตัวเลข 2 รายการที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberตัวเลขต่ำสุดจะซ่อนอยู่
endNumberจำนวนสูงสุดที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberNotEqualTo(number)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่เท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองต้องเป็นตัวเลข หากข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองไม่จำเป็นต้องเป็นตัวเลข แต่หากไม่ใช่ คุณอาจได้ผลลัพธ์ที่ไม่คาดคิด 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberหมายเลขที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenNumberNotEqualToAny(numbers)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีตัวเลขไม่เท่ากับตัวเลขที่ระบุ

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numbersNumber[]หมายเลขที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextContains(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งมีข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่เซลล์ต้องมี

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextDoesNotContain(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่มีข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่เซลล์ต้องไม่มี

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextEndsWith(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ลงท้ายด้วยข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ส่วนท้ายของข้อความในเซลล์ต้องมี

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextEqualTo(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ข้อความของเซลล์ต้องเท่ากับ

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextEqualToAny(texts)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับค่าข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textsString[]ค่าข้อความที่เซลล์ต้องเท่ากับ

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextNotEqualTo(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความไม่เท่ากับข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ข้อความของเซลล์ต้องไม่เท่ากับ

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextNotEqualToAny(texts)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความไม่เท่ากับค่าที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้ได้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ใช้เกณฑ์นี้กับตัวกรองในชีต DataSource, ชีตที่เชื่อมต่อกับฐานข้อมูล หรือ DataSourcePivotTable ซึ่งเป็นตาราง Pivot ที่สร้างขึ้นจากชีต 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textsString[]ค่าข้อความที่เซลล์ต้องไม่เท่ากับ

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

whenTextStartsWith(text)

ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ขึ้นต้นด้วยข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ข้อความเริ่มต้นของเซลล์ต้องมี

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม

withCriteria(criteria, args)

ตั้งค่าเกณฑ์การกรองเป็นเงื่อนไขบูลีนที่กําหนดโดยค่า BooleanCriteria เช่น CELL_EMPTY หรือ NUMBER_GREATER_THAN หากต้องการคัดลอกเงื่อนไขบูลีนจากเกณฑ์ที่มีอยู่ ให้กําหนดพารามิเตอร์สําหรับเมธอดนี้โดยใช้ getCriteriaType() และ getCriteriaValues() ในเกณฑ์ที่มีอยู่

คุณใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ แต่BooleanCriteriaบางรายการจะใช้กับตัวกรองบางประเภทไม่ได้ 

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
criteriaBooleanCriteriaประเภทของเกณฑ์บูลีน
argsObject[]อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และประเภทของอาร์กิวเมนต์ต้องตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน

รีเทิร์น

FilterCriteriaBuilder — ตัวสร้างนี้สําหรับการต่อเชื่อม