本頁面由 Cloud Translation API 翻譯而成。

Enum DataValidationCriteria

此列舉代表可在範圍中設定的資料驗證條件。

如要呼叫列舉，請呼叫其父項類別、名稱和屬性。例如 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`	輸入內容必須是網址格式。
`VALUE_IN_LIST`	`Enum`	要求輸入值等於指定值之一。
`VALUE_IN_RANGE`	`Enum`	要求輸入值必須等於指定範圍內的值。
`CUSTOM_FORMULA`	`Enum`	要求輸入內容可讓指定公式評估為 `true`。
`CHECKBOX`	`Enum`	輸入值必須是自訂值或布林值，並以核取方塊呈現。