Enum DataValidationCriteria

קריטריוניםלאימותנתונים

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

כדי לקרוא למאפיין enum, צריך לקרוא לכיתה ההורה, לשם ולנכס שלו. לדוגמה, SpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE.

// Change existing data-validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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	הרכיב הזה מחייב שהקלט יהיה ערך מותאם אישית או ערך בוליאני, והוא מוצג כתיבת סימון.