ספירה שמייצגת את הקריטריונים לאימות נתונים שניתן להגדיר בטווח.
כדי לקרוא לטיפוסים בני מנייה (enum), צריך לקרוא למחלקה, לשם ולנכס ההורה שלהם. לדוגמה,
SpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE
.
// Change existing data-validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
תכונות
נכס | תיאור | התיאור |
---|---|---|
DATE_AFTER | Enum | נדרש תאריך שחל אחרי הערך הנתון. |
DATE_BEFORE | Enum | כדי להשתמש בדוח צריך להזין תאריך שחל לפני הערך הנתון. |
DATE_BETWEEN | Enum | נדרש תאריך שנמצא בין הערכים הנתונים. |
DATE_EQUAL_TO | Enum | צריך לציין תאריך ששווה לערך הנתון. |
DATE_IS_VALID_DATE | Enum | נדרש תאריך. |
DATE_NOT_BETWEEN | Enum | יש לציין תאריך שאינו בין הערכים הנתונים. |
DATE_ON_OR_AFTER | Enum | נדרש תאריך שהוא זהה לערך הנתון או מאוחר ממנו. |
DATE_ON_OR_BEFORE | Enum | חובה לציין תאריך שהוא זהה לערך הנתון או מוקדם ממנו. |
NUMBER_BETWEEN | Enum | נדרש מספר שנמצא בין הערכים הנתונים. |
NUMBER_EQUAL_TO | Enum | נדרש מספר ששווה לערך הנתון. |
NUMBER_GREATER_THAN | Enum | נדרש מספר גדול מהערך הנתון. |
NUMBER_GREATER_THAN_OR_EQUAL_TO | Enum | כדי להשתמש בפונקציה הזאת יש צורך במספר שגדול מהערך הנתון או שווה לו. |
NUMBER_LESS_THAN | Enum | נדרש מספר הקטן מהערך הנתון. |
NUMBER_LESS_THAN_OR_EQUAL_TO | Enum | כדי להשתמש בפונקציה הזאת יש צורך במספר קטן מהערך הנתון או שווה לו. |
NUMBER_NOT_BETWEEN | Enum | נדרש מספר שאינו בין הערכים הנתונים. |
NUMBER_NOT_EQUAL_TO | Enum | נדרש מספר שאינו שווה לערך הנתון. |
TEXT_CONTAINS | Enum | כדי להשתמש בפונקציה הזו, הקלט צריך להכיל את הערך הנתון. |
TEXT_DOES_NOT_CONTAIN | Enum | כדי להשתמש בפונקציה הזו, הקלט לא מכיל את הערך הנתון. |
TEXT_EQUAL_TO | Enum | מחייב שהקלט יהיה שווה לערך הנתון. |
TEXT_IS_VALID_EMAIL | Enum | כדי להשתמש בדוח צריך להזין כתובת אימייל. |
TEXT_IS_VALID_URL | Enum | כדי להשתמש בדוח הזה, הקלט צריך להיות בצורת כתובת URL. |
VALUE_IN_LIST | Enum | מחייב שהקלט יהיה שווה לאחד מהערכים הנתונים. |
VALUE_IN_RANGE | Enum | מחייב שהקלט יהיה שווה לערך בטווח הנתון. |
CUSTOM_FORMULA | Enum | הפונקציה מחייבת שהקלט יגרום להערכה של הנוסחה הנתונה ל-true . |
CHECKBOX | Enum | כדי שהקלט יהיה ערך מותאם אישית או בוליאני, הקלט צריך להיות מוצג כתיבת סימון. |