Class DataValidationBuilder

DataValidationBuilder

데이터 유효성 검사 규칙의 빌더입니다.

// Set the data validation for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

메서드

메서드	반환 유형	간략한 설명
build()	DataValidation	빌더에 적용된 설정에서 데이터 유효성 검사 규칙을 생성합니다.
copy()	DataValidationBuilder	이 규칙의 설정을 기반으로 데이터 유효성 검사 규칙을 위한 빌더를 만듭니다.
getAllowInvalid()	Boolean	입력이 데이터 유효성 검사에 실패할 때 규칙을 경고를 표시하는 경우 true를 반환하고 입력을 완전히 거부하면 false를 반환합니다.
getCriteriaType()	DataValidationCriteria	DataValidationCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다.
getCriteriaValues()	Object[]	규칙 기준에 대한 인수 배열을 가져옵니다.
getHelpText()	String	규칙의 도움말 텍스트를 가져오거나, 설정된 도움말 텍스트가 없는 경우 null를 가져옵니다.
requireCheckbox()	DataValidationBuilder	입력이 불리언 값인지 요구하도록 데이터 확인 규칙을 설정합니다. 이 값은 체크박스로 렌더링됩니다.
requireCheckbox(checkedValue)	DataValidationBuilder	입력이 지정된 값이거나 비어 있도록 데이터 확인 규칙을 설정합니다.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	입력이 지정된 값 중 하나여야 하도록 데이터 확인 규칙을 설정합니다.
requireDate()	DataValidationBuilder	데이터 확인 규칙이 날짜를 요구하도록 설정합니다.
requireDateAfter(date)	DataValidationBuilder	지정된 값 이후의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다.
requireDateBefore(date)	DataValidationBuilder	지정한 값보다 이전 날짜가 필요하도록 데이터 확인 규칙을 설정합니다.
requireDateBetween(start, end)	DataValidationBuilder	2개 또는 2개 사이의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. 지정할 수 있습니다.
requireDateEqualTo(date)	DataValidationBuilder	지정된 값과 동일한 날짜를 요구하도록 데이터 확인 규칙을 설정합니다.
requireDateNotBetween(start, end)	DataValidationBuilder	데이터 확인 규칙이 두 개의 지정된 날짜입니다.
requireDateOnOrAfter(date)	DataValidationBuilder	지정된 값 이후의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다.
requireDateOnOrBefore(date)	DataValidationBuilder	지정된 값 또는 그 이전의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다.
requireFormulaSatisfied(formula)	DataValidationBuilder	지정된 수식이 true로 평가되도록 데이터 확인 규칙을 설정합니다.
requireNumberBetween(start, end)	DataValidationBuilder	2 사이의 숫자여야 하도록 데이터 확인 규칙을 설정합니다. 지정할 수 있습니다.
requireNumberEqualTo(number)	DataValidationBuilder	지정된 값과 동일한 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireNumberGreaterThan(number)	DataValidationBuilder	지정된 값보다 큰 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	지정된 값 이상의 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireNumberLessThan(number)	DataValidationBuilder	지정된 값보다 작은 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	지정된 값 이하의 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireNumberNotBetween(start, end)	DataValidationBuilder	데이터 확인 규칙이 다음 범위에 속하지 않는 숫자를 요구하도록 설정합니다. 두 개의 지정된 숫자입니다.
requireNumberNotEqualTo(number)	DataValidationBuilder	지정된 값과 같지 않은 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.
requireTextContains(text)	DataValidationBuilder	입력에 지정된 값이 포함되도록 데이터 확인 규칙을 설정합니다.
requireTextDoesNotContain(text)	DataValidationBuilder	입력에 지정된 값이 포함되지 않도록 데이터 확인 규칙을 설정합니다.
requireTextEqualTo(text)	DataValidationBuilder	입력이 지정된 값과 같도록 데이터 확인 규칙을 설정합니다.
requireTextIsEmail()	DataValidationBuilder	이메일 주소 형식으로 입력해야 하도록 데이터 확인 규칙을 설정합니다.
requireTextIsUrl()	DataValidationBuilder	URL 형식으로 입력하도록 데이터 확인 규칙을 설정합니다.
requireValueInList(values)	DataValidationBuilder	입력이 지정된 값 중 하나와 같도록 데이터 확인 규칙을 설정합니다.
requireValueInList(values, showDropdown)	DataValidationBuilder	입력이 지정된 값 중 하나와 같도록 데이터 확인 규칙을 설정합니다. 드롭다운 메뉴를 숨기는 옵션이 있습니다.
requireValueInRange(range)	DataValidationBuilder	입력이 지정된 범위의 값과 같도록 데이터 확인 규칙을 설정합니다.
requireValueInRange(range, showDropdown)	DataValidationBuilder	입력이 지정된 범위의 값과 같도록 데이터 확인 규칙을 설정합니다. 드롭다운 메뉴를 숨기는 옵션이 있습니다.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	입력이 데이터 검증에 실패할 때 경고를 표시할지 또는 입력을 거부할지 여부를 설정합니다. 있습니다.
setHelpText(helpText)	DataValidationBuilder	사용자가 데이터 확인이 있는 셀 위로 마우스를 가져가면 표시되는 도움말 텍스트를 설정합니다. 설정합니다.
withCriteria(criteria, args)	DataValidationBuilder	데이터 확인 규칙을 DataValidationCriteria 값으로 정의된 기준으로 설정합니다. 일반적으로 기존 규칙의 criteria 및 arguments에서 가져옵니다.

자세한 문서

build()

빌더에 적용된 설정에서 데이터 유효성 검사 규칙을 생성합니다.

리턴

DataValidation: 데이터 유효성 검사 규칙의 표현

---

copy()

이 규칙의 설정을 기반으로 데이터 유효성 검사 규칙을 위한 빌더를 만듭니다.

// 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);

리턴

DataValidationBuilder: 이 규칙의 설정을 기반으로 하는 빌더입니다.

---

getAllowInvalid()

입력이 데이터 유효성 검사에 실패할 때 규칙을 경고를 표시하는 경우 true를 반환하고 입력을 완전히 거부하면 false를 반환합니다. 새 데이터 확인 규칙의 기본값은 true입니다.

리턴

Boolean: 규칙에서 데이터 유효성 검사에 실패한 입력을 허용하는 경우 true 그렇지 않은 경우 false

---

getCriteriaType()

DataValidationCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다. 이 기준에 대한 인수가 있으면 getCriteriaValues()를 사용합니다. 이러한 값을 사용하여 데이터 유효성 검사 규칙을 수정하는 방법은 withCriteria(criteria, args)를 참고하세요.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

리턴

DataValidationCriteria: 데이터 검증 기준의 유형

---

getCriteriaValues()

규칙 기준에 대한 인수 배열을 가져옵니다. 기준 유형을 가져오려면 getCriteriaType()를 사용합니다. 이러한 값을 사용하여 데이터 확인 규칙을 만들거나 수정하려면 withCriteria(criteria, args)를 참고하세요.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

리턴

Object[]: 규칙의 기준 유형에 적합한 인수의 배열입니다. 인수 수 유형은 DataValidationBuilder 클래스의 상응하는 require...() 메서드와 일치합니다.

---

getHelpText()

규칙의 도움말 텍스트를 가져오거나, 설정된 도움말 텍스트가 없는 경우 null를 가져옵니다.

리턴

String: 규칙의 도움말 텍스트 또는 설정된 도움말 텍스트가 없는 경우 null

---

requireCheckbox()

입력이 불리언 값인지 요구하도록 데이터 확인 규칙을 설정합니다. 이 값은 체크박스로 렌더링됩니다.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireCheckbox(checkedValue)

입력이 지정된 값이거나 비어 있도록 데이터 확인 규칙을 설정합니다. 날짜 입력이 지정된 값과 일치하며 셀이 선택된 체크박스로 렌더링됩니다. 이 입력이 비어 있으면 셀이 선택 해제된 체크박스로 렌더링됩니다.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
checkedValue	Object	선택된 체크박스에 할당된 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireCheckbox(checkedValue, uncheckedValue)

입력이 지정된 값 중 하나여야 하도록 데이터 확인 규칙을 설정합니다. 날짜 입력은 checkedValue이며 셀이 선택된 체크박스로 렌더링됩니다. 이 uncheckedValue인 경우 셀이 선택 해제된 체크박스로 렌더링됩니다.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
checkedValue	Object	선택된 체크박스에 할당된 값입니다.
uncheckedValue	Object	선택 해제된 체크박스에 할당된 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDate()

데이터 확인 규칙이 날짜를 요구하도록 설정합니다.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateAfter(date)

지정된 값 이후의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. Date 객체는 무시됩니다. 일, 월, 연도 필드만 사용됩니다.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
date	Date	허용되지 않는 가장 최근 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateBefore(date)

지정한 값보다 이전 날짜가 필요하도록 데이터 확인 규칙을 설정합니다. Date 객체는 무시됩니다. 일, 월, 연도 필드만 사용됩니다.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
date	Date	허용되지 않는 최초 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateBetween(start, end)

2개 또는 2개 사이의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. 지정할 수 있습니다. Date 객체의 시간 필드는 무시됩니다. 일, 월, 연도 필드가 사용됩니다

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
start	Date	허용되는 가장 이른 날짜입니다.
end	Date	허용되는 가장 최근 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateEqualTo(date)

지정된 값과 동일한 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. 시간 필드는 Date 객체는 무시됩니다. 일, 월, 연도 필드만 사용됩니다.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
date	Date	유일하게 허용되는 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateNotBetween(start, end)

데이터 확인 규칙이 두 개의 지정된 날짜입니다. Date 객체의 시간 필드는 무시됩니다. 당일에만 월, 연도 필드가 사용됩니다

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
start	Date	허용되지 않는 최초 날짜입니다.
end	Date	허용되지 않는 가장 최근 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateOnOrAfter(date)

지정된 값 이후의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. 시간 필드는 Date 객체는 무시됩니다. 일, 월, 연도 필드만 사용됩니다.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
date	Date	허용되는 가장 이른 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireDateOnOrBefore(date)

지정된 값 또는 그 이전의 날짜를 요구하도록 데이터 확인 규칙을 설정합니다. 시간 필드 각 객체의 Date 객체가 무시됩니다. 일, 월, 연도 필드만 사용됩니다.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
date	Date	허용되는 가장 최근 날짜입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireFormulaSatisfied(formula)

지정된 수식이 true로 평가되도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
formula	String	입력이 유효한 경우 true로 평가되는 커스텀 수식입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberBetween(start, end)

2 사이의 숫자여야 하도록 데이터 확인 규칙을 설정합니다. 지정할 수 있습니다.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
start	Number	허용 가능한 최저 값입니다.
end	Number	허용되는 가장 높은 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberEqualTo(number)

지정된 값과 동일한 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	유일하게 허용되는 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberGreaterThan(number)

지정된 값보다 큰 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	허용되지 않는 최댓값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberGreaterThanOrEqualTo(number)

지정된 값 이상의 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	허용 가능한 최저 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberLessThan(number)

지정된 값보다 작은 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	허용되지 않는 최솟값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberLessThanOrEqualTo(number)

지정된 값 이하의 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	허용되는 가장 높은 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberNotBetween(start, end)

데이터 확인 규칙이 다음 범위에 속하지 않는 숫자를 요구하도록 설정합니다. 두 개의 지정된 숫자입니다.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
start	Number	허용되지 않는 최솟값입니다.
end	Number	허용되지 않는 최댓값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireNumberNotEqualTo(number)

지정된 값과 같지 않은 숫자를 요구하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
number	Number	허용되지 않는 유일한 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireTextContains(text)

입력에 지정된 값이 포함되도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
text	String	입력에 포함되어야 하는 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireTextDoesNotContain(text)

입력에 지정된 값이 포함되지 않도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
text	String	입력에 포함되면 안 되는 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireTextEqualTo(text)

입력이 지정된 값과 같도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
text	String	유일하게 허용되는 값입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireTextIsEmail()

이메일 주소 형식으로 입력해야 하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireTextIsUrl()

URL 형식으로 입력하도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireValueInList(values)

입력이 지정된 값 중 하나와 같도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
values	String[]	허용되는 값의 배열입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireValueInList(values, showDropdown)

입력이 지정된 값 중 하나와 같도록 데이터 확인 규칙을 설정합니다. 드롭다운 메뉴를 숨기는 옵션이 있습니다.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
values	String[]	허용되는 값의 배열입니다.
showDropdown	Boolean	스프레드시트에 값의 드롭다운 메뉴가 표시되어야 하는 경우 true, 없으면 false입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireValueInRange(range)

입력이 지정된 범위의 값과 같도록 데이터 확인 규칙을 설정합니다.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
range	Range	허용되는 값이 포함된 범위입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

requireValueInRange(range, showDropdown)

입력이 지정된 범위의 값과 같도록 데이터 확인 규칙을 설정합니다. 드롭다운 메뉴를 숨기는 옵션이 있습니다.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

매개변수

이름	유형	설명
range	Range	허용되는 값이 포함된 범위입니다.
showDropdown	Boolean	스프레드시트에 값의 드롭다운 메뉴가 표시되어야 하는 경우 true, 없으면 false입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

setAllowInvalid(allowInvalidData)

입력이 데이터 검증에 실패할 때 경고를 표시할지 또는 입력을 거부할지 여부를 설정합니다. 있습니다. 새 데이터 확인 규칙의 기본값은 true입니다.

매개변수

이름	유형	설명
allowInvalidData	Boolean	규칙이 데이터 검증에 실패한 입력을 허용해야 하는 경우 true이고, 없으면 false입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

setHelpText(helpText)

사용자가 데이터 확인이 있는 셀 위로 마우스를 가져가면 표시되는 도움말 텍스트를 설정합니다. 설정합니다.

매개변수

이름	유형	설명
helpText	String	설정할 도움말 텍스트입니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더

---

withCriteria(criteria, args)

데이터 확인 규칙을 DataValidationCriteria 값으로 정의된 기준으로 설정합니다. 일반적으로 기존 규칙의 criteria 및 arguments에서 가져옵니다.

// 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);

매개변수

이름	유형	설명
criteria	DataValidationCriteria	데이터 검증 기준의 유형입니다.
args	Object[]	기준 유형에 적합한 인수의 배열입니다. 인수의 수 및 유형은 위의 상응하는 require...() 메서드와 일치합니다.

리턴

DataValidationBuilder: 체이닝을 위한 이 빌더