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	要求输入为自定义值或布尔值；呈现为复选框。
DATE_AFTER_RELATIVE	Enum	需要一个晚于相对日期值的时间。
DATE_BEFORE_RELATIVE	Enum	需要一个早于相对日期值的时间。
DATE_EQUAL_TO_RELATIVE	Enum	需要一个与相对日期值相等的日期。