דף זה תורגם על ידי Cloud Translation API.

Class FilterCriteriaBuilder

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

יוצרים את הכלי ליצירת קריטריונים באמצעות SpreadsheetApp.newFilterCriteria().
מוסיפים הגדרות ל-builder באמצעות השיטות מהכיתה הזו.
אפשר להשתמש בפונקציה 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()`

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

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

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

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`visibleBackgroundColor`	`Color`	צבע הרקע שיוגדר. הצבע חייב להיות בסגנון 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);

פרמטרים

שם	סוג	תיאור
`visibleForegroundColor`	`Color`	צבע החזית שיוגדר. הצבע חייב להיות בסגנון 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);

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`date`	`Date`	התאריך האחרון להסתרה.

חזרה

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

פרמטרים

שם	סוג	תיאור
`date`	`RelativeDate`	התאריך היחסי האחרון.

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

`whenDateNotEqualTo(date)`

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

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

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

פרמטרים

שם	סוג	תיאור
`date`	`Date`	התאריך להסתרה.

חזרה

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

`whenDateNotEqualToAny(dates)`

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

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

פרמטרים

שם	סוג	תיאור
`dates`	`Date[]`	התאריכים להסתרה.

חזרה

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

פרמטרים

שם	סוג	תיאור
`formula`	`String`	נוסחה מותאמת אישית ששווה ל-`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);

פרמטרים

שם	סוג	תיאור
`start`	`Number`	המספר הנמוך ביותר להצגה.
`end`	`Number`	המספר הגבוה ביותר להצגה.

חזרה

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

פרמטרים

שם	סוג	תיאור
`number`	`Number`	המספר שיוצג.

חזרה

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

`whenNumberEqualToAny(numbers)`

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

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`number`	`Number`	המספר הגבוה ביותר להסתרה.

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`start`	`Number`	הסתרה של המספר הנמוך ביותר.
`end`	`Number`	המספר הגבוה ביותר להסתרה.

חזרה

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

פרמטרים

שם	סוג	תיאור
`number`	`Number`	המספר שיש להסתיר.

חזרה

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

`whenNumberNotEqualToAny(numbers)`

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`text`	`String`	הטקסט שהתא לא יכול להכיל.

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

`whenTextEqualToAny(texts)`

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

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

פרמטרים

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

חזרה

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

`whenTextNotEqualTo(text)`

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

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

פרמטרים

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

חזרה

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

`whenTextNotEqualToAny(texts)`

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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