Enum DataValidationCriteria

Critèresdevalidation

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

Pour appeler un enum, 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 indiquée.
DATE_BEFOREEnumVeuillez saisir une date antérieure à la valeur indiquée.
DATE_BETWEENEnumNécessite une date comprise entre les valeurs indiquées.
DATE_EQUAL_TOEnumNécessite une date égale à la valeur indiquée.
DATE_IS_VALID_DATEEnumVeuillez saisir une date.
DATE_NOT_BETWEENEnumNécessite une date qui ne se situe pas entre les valeurs indiquées.
DATE_ON_OR_AFTEREnumExige une date égale ou postérieure à la valeur indiqué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 indiquées.
NUMBER_EQUAL_TOEnumNécessite un nombre égal à la valeur indiquée.
NUMBER_GREATER_THANEnumExige un nombre supérieur à la valeur indiquée.
NUMBER_GREATER_THAN_OR_EQUAL_TOEnumNécessite un nombre supérieur ou égal à la valeur indiquée.
NUMBER_LESS_THANEnumNécessite un nombre inférieur à la valeur indiquée.
NUMBER_LESS_THAN_OR_EQUAL_TOEnumNécessite un nombre inférieur ou égal à la valeur indiquée.
NUMBER_NOT_BETWEENEnumNécessite un nombre qui ne se situe pas entre les valeurs indiquées.
NUMBER_NOT_EQUAL_TOEnumNécessite un nombre différent de la valeur indiquée.
TEXT_CONTAINSEnumExige que l'entrée contienne la valeur indiquée.
TEXT_DOES_NOT_CONTAINEnumExige que la saisie ne contienne pas la valeur indiquée.
TEXT_EQUAL_TOEnumExige que l'entrée soit égale à la valeur indiquée.
TEXT_IS_VALID_EMAILEnumExige que l'entrée soit une adresse e-mail.
TEXT_IS_VALID_URLEnumL'entrée doit être une URL.
VALUE_IN_LISTEnumExige que l'entrée soit égale à l'une des valeurs fournies.
VALUE_IN_RANGEEnumExige que l'entrée soit égale à une valeur de la plage donnée.
CUSTOM_FORMULAEnumExige que l'entrée donne la valeur true à la formule donnée.
CHECKBOXEnumExige que l'entrée soit une valeur personnalisée ou un booléen. Elle est affichée sous forme de case à cocher.
DATE_AFTER_RELATIVEEnumNécessite une date postérieure à la valeur de date relative.
DATE_BEFORE_RELATIVEEnumVeuillez saisir une date antérieure à la valeur de date relative.
DATE_EQUAL_TO_RELATIVEEnumNécessite une date égale à la valeur de date relative.