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 | 입력이 URL 형식이어야 합니다. |
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 | 상대 날짜 값과 동일한 날짜가 필요합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-04(UTC)
[null,null,["최종 업데이트: 2025-08-04(UTC)"],[[["\u003cp\u003e\u003ccode\u003eDataValidationCriteria\u003c/code\u003e is an enumeration used to define data validation rules for cell ranges in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eIt provides various criteria like \u003ccode\u003eDATE_BETWEEN\u003c/code\u003e, \u003ccode\u003eNUMBER_GREATER_THAN\u003c/code\u003e, \u003ccode\u003eTEXT_CONTAINS\u003c/code\u003e, and more to enforce data integrity.\u003c/p\u003e\n"],["\u003cp\u003eTo use a specific criterion, you refer to it through \u003ccode\u003eSpreadsheetApp.DataValidationCriteria\u003c/code\u003e followed by the specific property, for instance, \u003ccode\u003eSpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code example demonstrates how to modify existing data validation rules that require a date within a certain range.\u003c/p\u003e\n"]]],["`DataValidationCriteria` defines the types of data validation rules applicable to a spreadsheet range. You can retrieve or modify existing rules on a range, to change the validation criteria. For example, you can update all DATE_BETWEEN rules from a date range in 2013 to a new date range in 2014, by copying and modifying the existing rule, or set new validation criteria on a range to ensure certain data types, including dates, numbers, or text, fit within specified parameters.\n"],null,["# Enum DataValidationCriteria\n\nDataValidationCriteria\n\nAn enumeration representing the data validation criteria that can be set on a range.\n\nTo call an enum, you call its parent class, name, and property. For example, `\nSpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE`.\n\n```javascript\n// Change existing data-validation rules that require a date in 2013 to require\n// a date in 2014.\nconst oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];\nconst newDates = [new Date('1/1/2014'), new Date('12/31/2014')];\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());\nconst rules = range.getDataValidations();\n\nfor (let i = 0; i \u003c rules.length; i++) {\n for (let j = 0; j \u003c rules[i].length; j++) {\n const rule = rules[i][j];\n\n if (rule != null) {\n const criteria = rule.getCriteriaType();\n const args = rule.getCriteriaValues();\n\n if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&\n args[0].getTime() === oldDates[0].getTime() &&\n args[1].getTime() === oldDates[1].getTime()) {\n // Create a builder from the existing rule, then change the dates.\n rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();\n }\n }\n }\n}\nrange.setDataValidations(rules);\n``` \n\n### Properties\n\n| Property | Type | Description |\n|-----------------------------------|--------|---------------------------------------------------------------------------------|\n| `DATE_AFTER` | `Enum` | Requires a date that is after the given value. |\n| `DATE_BEFORE` | `Enum` | Requires a date that is before the given value. |\n| `DATE_BETWEEN` | `Enum` | Requires a date that is between the given values. |\n| `DATE_EQUAL_TO` | `Enum` | Requires a date that is equal to the given value. |\n| `DATE_IS_VALID_DATE` | `Enum` | Requires a date. |\n| `DATE_NOT_BETWEEN` | `Enum` | Requires a date that is not between the given values. |\n| `DATE_ON_OR_AFTER` | `Enum` | Require a date that is on or after the given value. |\n| `DATE_ON_OR_BEFORE` | `Enum` | Requires a date that is on or before the given value. |\n| `NUMBER_BETWEEN` | `Enum` | Requires a number that is between the given values. |\n| `NUMBER_EQUAL_TO` | `Enum` | Requires a number that is equal to the given value. |\n| `NUMBER_GREATER_THAN` | `Enum` | Require a number that is greater than the given value. |\n| `NUMBER_GREATER_THAN_OR_EQUAL_TO` | `Enum` | Requires a number that is greater than or equal to the given value. |\n| `NUMBER_LESS_THAN` | `Enum` | Requires a number that is less than the given value. |\n| `NUMBER_LESS_THAN_OR_EQUAL_TO` | `Enum` | Requires a number that is less than or equal to the given value. |\n| `NUMBER_NOT_BETWEEN` | `Enum` | Requires a number that is not between the given values. |\n| `NUMBER_NOT_EQUAL_TO` | `Enum` | Requires a number that is not equal to the given value. |\n| `TEXT_CONTAINS` | `Enum` | Requires that the input contains the given value. |\n| `TEXT_DOES_NOT_CONTAIN` | `Enum` | Requires that the input does not contain the given value. |\n| `TEXT_EQUAL_TO` | `Enum` | Requires that the input is equal to the given value. |\n| `TEXT_IS_VALID_EMAIL` | `Enum` | Requires that the input is in the form of an email address. |\n| `TEXT_IS_VALID_URL` | `Enum` | Requires that the input is in the form of a URL. |\n| `VALUE_IN_LIST` | `Enum` | Requires that the input is equal to one of the given values. |\n| `VALUE_IN_RANGE` | `Enum` | Requires that the input is equal to a value in the given range. |\n| `CUSTOM_FORMULA` | `Enum` | Requires that the input makes the given formula evaluate to `true`. |\n| `CHECKBOX` | `Enum` | Requires that the input is a custom value or a boolean; rendered as a checkbox. |\n| `DATE_AFTER_RELATIVE` | `Enum` | Requires a date that is after the relative date value. |\n| `DATE_BEFORE_RELATIVE` | `Enum` | Requires a date that is before the relative date value. |\n| `DATE_EQUAL_TO_RELATIVE` | `Enum` | Requires a date that is equal to the relative date value. |"]]