Enum DataValidationCriteria

DataValidationCriteria

列舉表示可在特定範圍內設定的資料驗證條件。

如要呼叫列舉,您可以呼叫其父項類別、名稱和屬性。例如 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且必須以網址的形式輸入。
VALUE_IN_LISTEnum要求輸入必須等於其中一個指定值。
VALUE_IN_RANGEEnum要求的輸入值必須等於指定範圍內的值。
CUSTOM_FORMULAEnum此輸入內容要求輸入後,指定公式的計算結果為 true
CHECKBOXEnum必須輸入自訂值或布林值;顯示為核取方塊。