列舉代表可設定範圍的資料驗證條件。
如要呼叫列舉,您可以呼叫其父項類別、名稱和屬性。例如
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_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 | 輸入內容必須是自訂值或布林值,才能顯示為核取方塊。 |