Enum DataValidationCriteria

DataValidationCriteria

Uma enumeração que representa os critérios de validação de dados que podem ser definidos em um intervalo.

Para chamar um tipo enumerado, chame a classe mãe, o nome e a propriedade dele. Por exemplo, 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);

Propriedades

PropriedadeTipoDescrição
DATE_AFTEREnumRequer uma data posterior ao valor fornecido.
DATE_BEFOREEnumRequer uma data anterior ao valor fornecido.
DATE_BETWEENEnumRequer uma data que esteja entre os valores fornecidos.
DATE_EQUAL_TOEnumExige uma data igual ao valor informado.
DATE_IS_VALID_DATEEnumRequer uma data.
DATE_NOT_BETWEENEnumRequer uma data que não esteja entre os valores fornecidos.
DATE_ON_OR_AFTEREnumExige uma data que seja igual ou posterior ao valor fornecido.
DATE_ON_OR_BEFOREEnumRequer uma data que seja igual ou anterior ao valor fornecido.
NUMBER_BETWEENEnumExige um número entre os valores fornecidos.
NUMBER_EQUAL_TOEnumRequer um número igual ao valor fornecido.
NUMBER_GREATER_THANEnumExige um número maior que o valor fornecido.
NUMBER_GREATER_THAN_OR_EQUAL_TOEnumRequer um número maior ou igual ao valor fornecido.
NUMBER_LESS_THANEnumRequer um número menor que o valor fornecido.
NUMBER_LESS_THAN_OR_EQUAL_TOEnumRequer um número menor ou igual ao valor informado.
NUMBER_NOT_BETWEENEnumRequer um número que não esteja entre os valores fornecidos.
NUMBER_NOT_EQUAL_TOEnumRequer um número diferente do valor informado.
TEXT_CONTAINSEnumExige que a entrada contenha o valor fornecido.
TEXT_DOES_NOT_CONTAINEnumRequer que a entrada não contenha o valor fornecido.
TEXT_EQUAL_TOEnumExige que a entrada seja igual ao valor informado.
TEXT_IS_VALID_EMAILEnumExige que a entrada esteja na forma de um endereço de e-mail.
TEXT_IS_VALID_URLEnumExige que a entrada esteja na forma de um URL.
VALUE_IN_LISTEnumExige que a entrada seja igual a um dos valores fornecidos.
VALUE_IN_RANGEEnumExige que a entrada seja igual a um valor no intervalo fornecido.
CUSTOM_FORMULAEnumRequer que a entrada faça com que a fórmula fornecida seja avaliada como true.
CHECKBOXEnumexige que a entrada seja um valor personalizado ou booleano; renderizados como uma caixa de seleção.