Enum DataValidationCriteria

DataValidationCriteria

Énumération représentant les critères de validation des données pouvant être définis sur une plage.

Pour appeler une énumération, vous devez appeler sa classe parente, son nom et sa propriété. Par exemple, 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);

Propriétés

PropriétéTypeDescription
DATE_AFTEREnumNécessite une date postérieure à la valeur donnée.
DATE_BEFOREEnumNécessite une date antérieure à la valeur donnée.
DATE_BETWEENEnumRequiert une date comprise entre les valeurs données.
DATE_EQUAL_TOEnumNécessite une date égale à la valeur donnée.
DATE_IS_VALID_DATEEnumNécessite une date.
DATE_NOT_BETWEENEnumNécessite une date qui n'est pas comprise entre les valeurs données.
DATE_ON_OR_AFTEREnumExiger une date égale ou postérieure à la valeur donnée.
DATE_ON_OR_BEFOREEnumNécessite une date identique ou antérieure à la valeur donnée.
NUMBER_BETWEENEnumNécessite un nombre compris entre les valeurs données.
NUMBER_EQUAL_TOEnumNécessite un nombre égal à la valeur donnée.
NUMBER_GREATER_THANEnumExiger un nombre supérieur à la valeur donnée.
NUMBER_GREATER_THAN_OR_EQUAL_TOEnumNécessite un nombre supérieur ou égal à la valeur donnée.
NUMBER_LESS_THANEnumNécessite un nombre inférieur à la valeur donnée.
NUMBER_LESS_THAN_OR_EQUAL_TOEnumNécessite un nombre inférieur ou égal à la valeur donnée.
NUMBER_NOT_BETWEENEnumNécessite un nombre qui n'est pas compris entre les valeurs données.
NUMBER_NOT_EQUAL_TOEnumNécessite un nombre différent de la valeur donnée.
TEXT_CONTAINSEnumNécessite que l'entrée contienne la valeur donnée.
TEXT_DOES_NOT_CONTAINEnumNécessite que l'entrée ne contienne pas la valeur donnée.
TEXT_EQUAL_TOEnumNécessite que l'entrée soit égale à la valeur donnée.
TEXT_IS_VALID_EMAILEnumL'entrée doit se présenter sous la forme d'une adresse e-mail.
TEXT_IS_VALID_URLEnumNécessite que l'entrée se présente sous la forme d'une URL.
VALUE_IN_LISTEnumNécessite que l'entrée soit égale à l'une des valeurs données.
VALUE_IN_RANGEEnumNécessite que l'entrée soit égale à une valeur comprise dans la plage donnée.
CUSTOM_FORMULAEnumNécessite que l'entrée fasse correspondre la formule donnée à true.
CHECKBOXEnumNécessite que l'entrée soit une valeur personnalisée ou une valeur booléenne, affichée sous forme de case à cocher.