Class DataValidation

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

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

Return 키

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

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

Return 키

Boolean - 규칙이 데이터 검증에 실패한 입력을 허용하는 경우 true, 그렇지 않은 경우 false

DataValidationCriteria enum에 정의된 규칙의 기준 유형을 가져옵니다. 기준에 대한 인수를 가져오려면 getCriteriaValues()를 사용합니다. 이러한 값을 사용하여 데이터 검증 규칙을 만들거나 수정하려면 DataValidationBuilder.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.')
}

Return 키

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

규칙 기준에 대한 인수 배열을 가져옵니다. 기준 유형을 가져오려면 getCriteriaType()를 사용하세요. 이러한 값을 사용하여 데이터 유효성 검사 규칙을 만들거나 수정하려면 DataValidationBuilder.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.')
}

Return 키

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

규칙의 도움말 텍스트를 가져오거나, 도움말 텍스트가 설정되지 않은 경우 null를 가져옵니다.

Return 키

String: 규칙의 도움말 텍스트 또는 도움말 텍스트가 설정되지 않은 경우 null