Enum DataValidationCriteria

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.
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_AFTEREnumנדרש תאריך שחל אחרי הערך הנתון.
DATE_BEFOREEnumכדי להשתמש בדוח צריך להזין תאריך שחל לפני הערך הנתון.
DATE_BETWEENEnumנדרש תאריך שנמצא בין הערכים הנתונים.
DATE_EQUAL_TOEnumצריך לציין תאריך ששווה לערך הנתון.
DATE_IS_VALID_DATEEnumנדרש תאריך.
DATE_NOT_BETWEENEnumיש לציין תאריך שאינו בין הערכים הנתונים.
DATE_ON_OR_AFTEREnumנדרש תאריך שהוא זהה לערך הנתון או מאוחר ממנו.
DATE_ON_OR_BEFOREEnumחובה לציין תאריך שהוא זהה לערך הנתון או מוקדם ממנו.
NUMBER_BETWEENEnumנדרש מספר שנמצא בין הערכים הנתונים.
NUMBER_EQUAL_TOEnumנדרש מספר ששווה לערך הנתון.
NUMBER_GREATER_THANEnumנדרש מספר גדול מהערך הנתון.
NUMBER_GREATER_THAN_OR_EQUAL_TOEnumכדי להשתמש בפונקציה הזאת יש צורך במספר שגדול מהערך הנתון או שווה לו.
NUMBER_LESS_THANEnumנדרש מספר הקטן מהערך הנתון.
NUMBER_LESS_THAN_OR_EQUAL_TOEnumכדי להשתמש בפונקציה הזאת יש צורך במספר קטן מהערך הנתון או שווה לו.
NUMBER_NOT_BETWEENEnumנדרש מספר שאינו בין הערכים הנתונים.
NUMBER_NOT_EQUAL_TOEnumנדרש מספר שאינו שווה לערך הנתון.
TEXT_CONTAINSEnumכדי להשתמש בפונקציה הזו, הקלט צריך להכיל את הערך הנתון.
TEXT_DOES_NOT_CONTAINEnumכדי להשתמש בפונקציה הזו, הקלט לא מכיל את הערך הנתון.
TEXT_EQUAL_TOEnumמחייב שהקלט יהיה שווה לערך הנתון.
TEXT_IS_VALID_EMAILEnumכדי להשתמש בדוח צריך להזין כתובת אימייל.
TEXT_IS_VALID_URLEnumכדי להשתמש בדוח הזה, הקלט צריך להיות בצורת כתובת URL.
VALUE_IN_LISTEnumמחייב שהקלט יהיה שווה לאחד מהערכים הנתונים.
VALUE_IN_RANGEEnumמחייב שהקלט יהיה שווה לערך בטווח הנתון.
CUSTOM_FORMULAEnumהפונקציה מחייבת שהקלט יגרום להערכה של הנוסחה הנתונה ל-true.
CHECKBOXEnumכדי שהקלט יהיה ערך מותאם אישית או בוליאני, הקלט צריך להיות מוצג כתיבת סימון.