Class FilterCriteriaBuilder

FilterCriteriaBuilder

כדי להוסיף קריטריונים למסנן:

  1. יוצרים את הכלי ליצירת קריטריונים באמצעות SpreadsheetApp.newFilterCriteria().
  2. מוסיפים הגדרות ל-builder באמצעות השיטות מהכיתה הזו.
  3. אפשר להשתמש בפונקציה build() כדי להרכיב את הקריטריונים עם ההגדרות שצוינו.

שימושים נפוצים

הסתרת ערכים בגיליון

בדוגמה הבאה מקבלים מסנן קיים של גיליון ומוסיפים קריטריונים להסתרת התאים עמודה C שמכילה את המילה "hello" או 'עולם'. הקריטריונים בדוגמה הזו משמשים רק במקרים הבאים: ב-Grid גיליונות, סוג ברירת המחדל של הגיליון.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

הצגת תאים שאינם ריקים

בדוגמה הבאה מתווסף מסנן לגיליון DataSource, גיליון מחובר למסד נתונים, עם קריטריונים שמציגים רק תאים מהקטגוריה "קטגוריה" עמודה לא ריקים.
// 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);

שיטות

שיטהסוג הערך המוחזרתיאור קצר
build()FilterCriteriaהרכב את קריטריוני המסנן באמצעות ההגדרות שאתה מוסיף לבונה הקריטריונים.
copy()FilterCriteriaBuilderמעתיק את הקריטריונים של המסנן ויוצר כלי ליצירת קריטריונים שאפשר להחיל על מסנן אחר
getCriteriaType()BooleanCriteriaמחזירה את הסוג הבוליאני של הקריטריונים, לדוגמה, CELL_EMPTY.
getCriteriaValues()Object[]מחזירה מערך של ארגומנטים עבור קריטריונים בוליאניים.
getHiddenValues()String[]מחזירה את הערכים שהמסנן מסתיר.
getVisibleBackgroundColor()Colorהפונקציה מחזירה את צבע הרקע שמשמש כקריטריון לסינון.
getVisibleForegroundColor()Colorהפונקציה מחזירה את צבע החזית שמשמש כקריטריון לסינון.
getVisibleValues()String[]מחזירה את הערכים שמוצגים במסנן של טבלת הצירים.
setHiddenValues(values)FilterCriteriaBuilderמגדיר את הערכים להסתרה.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderהגדרת צבע הרקע שמשמש כקריטריונים לסינון.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderהגדרת צבע החזית שמשמש כקריטריונים לסינון.
setVisibleValues(values)FilterCriteriaBuilderמגדירה את הערכים שיוצגו בטבלת צירים.
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();
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);

חזרה

FilterCriteria – ייצוג של קריטריון הסינון.


copy()

מעתיק את הקריטריונים של המסנן ויוצר כלי ליצירת קריטריונים שאפשר להחיל על מסנן אחר

אפשר להשתמש בשיטה הזו עם כל סוג של מסנן. אם משתמשים במסנן גיליון, אפשר: מעתיקים את הקריטריונים לעמודה אחרת.

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

חזרה

FilterCriteriaBuilder – כלי ליצירת קריטריוני סינון על סמך קריטריוני הסינון האלה.


getCriteriaType()

מחזירה את הסוג הבוליאני של הקריטריונים, לדוגמה, CELL_EMPTY. מידע נוסף על הסוגים של קריטריונים בוליאניים, ראה BooleanCriteria enum.

בדרך כלל אנשים משתמשים בשיטה הזו כדי להוסיף קריטריונים של תנאי בוליאני למסנן, בלי להחליף אותם קריטריונים קיימים.

  • כדי לקבל את הארגומנטים של הקריטריונים, משתמשים בפונקציה getCriteriaValues().
  • כדי להשתמש בסוג הקריטריונים ובערכי הקריטריונים כדי ליצור או לשנות קריטריוני סינון, אפשר לעיין במאמר withCriteria(criteria, args)

אפשר להשתמש בשיטה הזו לכל סוג של מסנן. אם קריטריון הסינון אינו בוליאני מצב, מחזירה null.

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

חזרה

BooleanCriteria — סוג הקריטריונים הבוליאניים, או null אם הקריטריונים אינם בוליאניים תנאי.


getCriteriaValues()

מחזירה מערך של ארגומנטים עבור קריטריונים בוליאניים. חלק מסוגי הקריטריונים הבוליאניים לא ארגומנטים ולהחזיר מערך ריק, לדוגמה, CELL_NOT_EMPTY.

בדרך כלל אנשים משתמשים בשיטה הזו כדי להוסיף קריטריונים של תנאי בוליאני למסנן, בלי להחליף אותם קריטריונים קיימים.

  • כדי לקבל את סוג הקריטריונים הבוליאניים, יש להשתמש בפונקציה getCriteriaType().
  • כדי להשתמש בסוג הקריטריונים ובערכי הקריטריונים כדי ליצור או לשנות קריטריונים לסינון, ראו: withCriteria(criteria, args)

    אפשר להשתמש בשיטה הזו לכל סוג של מסנן.

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

    חזרה

    Object[] — מערך ארגומנטים שמתאים לסוג הקריטריונים הבוליאניים. מספר הארגומנטים והסוג שלהם תואם לשיטה when...() המתאימה במחלקה FilterCriteriaBuilder.


getHiddenValues()

מחזירה את הערכים שהמסנן מסתיר.

צריך להשתמש בקריטריונים האלה יחד עם מסננים ב-Grid גיליונות, שהוא סוג ברירת המחדל של הגיליון. הפונקציה מחזירה את הערך null אם קוראים לשיטה הזו לסוגים אחרים של מסננים.

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

חזרה

String[] – מערך ערכים שהמסנן מסתיר.


getVisibleBackgroundColor()

הפונקציה מחזירה את צבע הרקע שמשמש כקריטריון לסינון. תאים עם צבע הרקע הזה יישארו גלוי.

צריך להשתמש בקריטריונים האלה יחד עם מסננים ב-Grid גיליונות, שהוא סוג ברירת המחדל של הגיליון. הפונקציה מחזירה את הערך null אם קוראים לשיטה הזו לסוגים אחרים של מסננים.

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

חזרה

Color – צבע הרקע שמשמש כקריטריונים לסינון.


getVisibleForegroundColor()

הפונקציה מחזירה את צבע החזית שמשמש כקריטריון לסינון. תאים עם הצבע הקדמי הזה יישארו גלוי.

צריך להשתמש בקריטריונים האלה יחד עם מסננים ב-Grid גיליונות, שהוא סוג ברירת המחדל של הגיליון. הפונקציה מחזירה את הערך null אם קוראים לשיטה הזו לסוגים אחרים של מסננים.

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

חזרה

Color – צבע החזית שמשמש כקריטריונים לסינון.


getVisibleValues()

מחזירה את הערכים שמוצגים במסנן של טבלת הצירים.

הקריטריונים האלה מיועדים רק למסננים בטבלאות צירים שלא מחוברות למסד נתונים. מחזירה מערך ריק לסוגים אחרים של מסננים.

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

חזרה

String[] – מערך ערכים שמוצג במסנן טבלת הצירים.


setHiddenValues(values)

מגדיר את הערכים להסתרה. ניקוי כל הערכים הגלויים או המוסתרים הקיימים.

אפשר להשתמש בקריטריונים האלה רק למסננים ב-Grid גיליונות, ברירת המחדל סוג הגיליון.

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

פרמטרים

שםסוגתיאור
valuesString[]רשימת הערכים להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.

קליעות

Error – אם אחד מהערכים הוא null.


setVisibleBackgroundColor(visibleBackgroundColor)

הגדרת צבע הרקע שמשמש כקריטריונים לסינון. תאים עם צבע הרקע הזה יישארו גלוי. הגדרת קריטריונים לסינון צבעי רקע מסירה את כל הקריטריונים הנוכחיים לסינון צבעים מה-builder הזה.

אפשר להשתמש בקריטריונים האלה רק למסננים ב-Grid גיליונות, ברירת המחדל סוג הגיליון.

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

פרמטרים

שםסוגתיאור
visibleBackgroundColorColorצבע הרקע שיוגדר. הצבע חייב להיות בסגנון RGB צבע. השיטה הזו לא תומכת בצבעי עיצוב.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


setVisibleForegroundColor(visibleForegroundColor)

הגדרת צבע החזית שמשמש כקריטריונים לסינון. תאים עם הצבע הקדמי הזה יישארו גלוי. הגדרת קריטריונים לסינון לפי צבע בחזית מסירה את כל הקריטריונים הנוכחיים לסינון צבעים מה-builder הזה.

אפשר להשתמש בקריטריונים האלה רק למסננים ב-Grid גיליונות, ברירת המחדל סוג הגיליון.

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

פרמטרים

שםסוגתיאור
visibleForegroundColorColorצבע החזית שיוגדר. הצבע חייב להיות בסגנון RGB צבע. השיטה הזו לא תומכת בצבעי עיצוב.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


setVisibleValues(values)

מגדירה את הערכים שיוצגו בטבלת צירים. ניקוי כל הערכים הגלויים או המוסתרים הקיימים.

אפשר להשתמש בקריטריונים האלה רק למסננים בטבלאות צירים שלא מחוברות מסד נתונים.

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

פרמטרים

שםסוגתיאור
valuesString[]רשימת הערכים להצגה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.

קליעות

Error – אם אחד מהערכים הוא null.


whenCellEmpty()

מגדיר את קריטריוני הסינון להצגת תאים ריקים.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenCellNotEmpty()

מגדיר את קריטריוני הסינון כדי להציג תאים שאינם ריקים.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateAfter(date)

מגדיר קריטריונים לסינון תאים עם תאריכים שחלו אחרי התאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateDateהתאריך האחרון להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateAfter(date)

מגדירה קריטריוני סינון להצגת תאים עם תאריכים שחלו אחרי התאריך היחסי שצוין. שפת תרגום להציג את אפשרויות התאריכים היחסיות, במספר RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateRelativeDateהתאריך היחסי האחרון.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateBefore(date)

הגדרת קריטריונים לסינון תאים עם תאריכים שחלו לפני התאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateDateהתאריך המוקדם ביותר להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateBefore(date)

מגדירה קריטריוני סינון להצגת תאים עם תאריכים שחלו לפני התאריך היחסי שצוין. כדי להציג את אפשרויות התאריכים היחסיות, עיינו ב-Enum RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateRelativeDateהתאריך היחסי המוקדם ביותר להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateEqualTo(date)

מגדירה קריטריון לסינון כדי להציג תאים עם תאריכים ששווים לתאריך שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateDateהתאריך שבו ערכי התאים חייבים להתאים.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateEqualTo(date)

מגדירה קריטריון לסינון כדי להציג תאים עם תאריכים ששווים לתאריך היחסי שצוין. כדי להציג את אפשרויות התאריכים היחסיות, עיינו ב-Enum RelativeDate.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך. אם אין קישור בין הנתונים האלה למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים את הנתונים לא חייב להיות תאריך, אבל אם זה לא התאריך, יכול להיות שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
dateRelativeDateהתאריך היחסי שבו ערכי התאים חייבים להתאים.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateEqualToAny(dates)

מגדיר את קריטריוני הסינון כדי להציג תאים עם תאריכים ששווים לאחד מהתאריכים שצוינו.

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
datesDate[]התאריכים להצגה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateNotEqualTo(date)

מגדיר את קריטריוני הסינון להצגת תאים שלא זהים לתאריך שצוין.

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות תאריך.

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

פרמטרים

שםסוגתיאור
dateDateהתאריך להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenDateNotEqualToAny(dates)

הגדרה של קריטריוני הסינון להצגת תאים עם תאריכים שלא שווים לאף אחד מהקריטריונים שצוינו תאריכים.

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
datesDate[]התאריכים להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenFormulaSatisfied(formula)

הגדרה של קריטריוני הסינון כדי להציג תאים עם נוסחה ספציפית (כמו =B:B<C:C) התוצאה היא true.

אפשר להשתמש בקריטריונים האלה רק כדי לסנן נתונים שלא מקושרים למסד נתונים.

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

פרמטרים

שםסוגתיאור
formulaStringנוסחה מותאמת אישית ששווה ל-true אם הקלט תקין.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberBetween(start, end)

מגדיר את קריטריוני הסינון כדי להציג תאים עם מספר שנמצא בטווח של 2 או שהוא אחד מהם במספרים מסוימים שהוגדרו.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
startNumberהמספר הנמוך ביותר להצגה.
endNumberהמספר הגבוה ביותר להצגה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberEqualTo(number)

מגדיר את קריטריוני הסינון כדי להציג תאים עם מספר ששווה למספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר שיוצג.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberEqualToAny(numbers)

הגדרה של קריטריוני הסינון כדי להציג תאים עם מספר ששווה לאחד מהערכים שצוינו .

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
numbersNumber[]המספרים שיוצגו.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberGreaterThan(number)

הגדרה של קריטריוני הסינון כך שיוצגו תאים עם מספר גדול יותר מהמספר שצוין

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הגבוה ביותר להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberGreaterThanOrEqualTo(number)

הגדרה של קריטריוני הסינון כדי להציג תאים עם מספר שגדול מהערך שצוין או שווה לו מספר.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הנמוך ביותר להצגה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberLessThan(number)

מגדיר את קריטריון הסינון כך שיציג תאים עם מספר קטן מהמספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הנמוך ביותר להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberLessThanOrEqualTo(number)

הגדרה של קריטריוני הסינון כדי להציג תאים עם מספר שקטן מהערך שצוין או שווה לו מספר.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר הגבוה ביותר להצגה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberNotBetween(start, end)

הגדרה של קריטריוני הסינון כך שיוצגו תאים עם מספר שלא נמצא ביניהם וגם לא 2 במספרים מסוימים שהוגדרו.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
startNumberהסתרה של המספר הנמוך ביותר.
endNumberהמספר הגבוה ביותר להסתרה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberNotEqualTo(number)

מגדיר את קריטריון הסינון כך שיציג תאים עם מספר שלא שווה למספר שצוין.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן. אם תשתמשו בקריטריונים האלה עם נתונים שמקושרות למסד נתונים, סוג הנתונים של העמודה שלפיה אתם מסננים חייב להיות מספר. אם המיקום הנתונים לא מקושרים למסד נתונים, סוג הנתונים של העמודה שלפיה מתבצע סינון חייב להיות מספר, אבל אם הוא לא, ייתכן שיתקבלו תוצאות בלתי צפויות.

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

פרמטרים

שםסוגתיאור
numberNumberהמספר שיש להסתיר.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenNumberNotEqualToAny(numbers)

הגדרה של קריטריוני הסינון כדי להציג תאים עם מספר שלא שווה לאף אחד מהערכים שצוינו .

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
numbersNumber[]המספרים שרוצים להסתיר.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextContains(text)

מגדירה את קריטריוני הסינון כך שיציגו תאים עם טקסט שמכיל את הטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שהתא צריך להכיל.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextDoesNotContain(text)

מגדיר את הקריטריונים לסינון כדי להציג תאים עם טקסט שלא מכיל את הטקסט שצוין. הוא לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שהתא לא יכול להכיל.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextEndsWith(text)

מגדיר את קריטריוני הסינון כך שיציגו תאים עם טקסט שמסתיים בטקסט שצוין. הטקסט אינו תלוי אותיות רישיות.

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שסוף הטקסט של התא צריך להכיל.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextEqualTo(text)

מגדיר את קריטריוני הסינון כדי להציג תאים עם טקסט ששווה לטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שהטקסט בתא צריך להיות שווה לו.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextEqualToAny(texts)

הגדרה של קריטריוני הסינון כדי להציג תאים עם טקסט ששווה לאחד מהטקסטים שצוינו ערכים. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
textsString[]ערכי הטקסט שתא צריך להיות שווה להם.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextNotEqualTo(text)

מגדיר את קריטריוני הסינון כך שיציגו תאים עם טקסט שלא זהה לטקסט שצוין. הוא לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שהטקסט בתא לא יכול להיות שווה לו.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextNotEqualToAny(texts)

הגדרה של קריטריוני הסינון כדי להציג תאים עם טקסט שלא שווה לאף אחד מהערכים שצוינו ערכים. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה רק בנתונים שמקושרים למסד נתונים. לדוגמה, השתמשו בהנחיה הזו קריטריונים עם מסננים בגיליון DataSource, גיליון שמחובר אל או DataSourcePivotTable, טבלת צירים שנוצרה מגיליון DataSource.

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

פרמטרים

שםסוגתיאור
textsString[]ערכי הטקסט שתא לא יכול להיות שווה להם.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


whenTextStartsWith(text)

מגדיר את קריטריוני הסינון כך שיציגו תאים עם טקסט שמתחיל בטקסט שצוין. הטקסט לא תלוי אותיות רישיות (case-sensitive).

אפשר להשתמש בקריטריונים האלה עם כל סוג של מסנן.

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

פרמטרים

שםסוגתיאור
textStringהטקסט שתחילת הטקסט של התא צריכה להכיל.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.


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

פרמטרים

שםסוגתיאור
criteriaBooleanCriteriaסוג הקריטריונים הבוליאניים.
argsObject[]מערך של ארגומנטים שמתאים לסוג הקריטריונים; את מספר הארגומנטים הסוג שלהן תואם לשיטות when...() המתאימות שמצוינות למעלה.

חזרה

FilterCriteriaBuilder – ה-builder הזה, לשרשורים.