Enum DataValidationCriteria

Critèresdevalidation des données

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

Pour appeler un é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.
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);

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_BETWEENEnumNécessite une date comprise entre les valeurs données.
DATE_EQUAL_TOEnumNécessite une date égale à la valeur donnée.
DATE_IS_VALID_DATEEnumVous devez indiquer une date.
DATE_NOT_BETWEENEnumNécessite une date qui ne se situe pas 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 indiqué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 ne se situe pas entre les valeurs données.
NUMBER_NOT_EQUAL_TOEnumNécessite un nombre qui n'est pas égal à la valeur donnée.
TEXT_CONTAINSEnumExige que la valeur saisie contienne la valeur donnée.
TEXT_DOES_NOT_CONTAINEnumExige que la valeur saisie ne contienne pas la valeur donnée.
TEXT_EQUAL_TOEnumL'entrée doit être égale à la valeur donnée.
TEXT_IS_VALID_EMAILEnumNécessite que la valeur saisie soit une adresse e-mail.
TEXT_IS_VALID_URLEnumL'entrée doit être au format d'une URL.
VALUE_IN_LISTEnumExige que la valeur d'entrée soit égale à l'une des valeurs données.
VALUE_IN_RANGEEnumExige que la valeur saisie soit égale à une valeur de la plage donnée.
CUSTOM_FORMULAEnumNécessite que l'entrée fasse en sorte que la formule donnée soit évaluée à true.
CHECKBOXEnumNécessite que la valeur saisie soit une valeur personnalisée ou un booléen. Affichée sous forme de case à cocher.