Class DataValidationBuilder

Crea una regla de validación de datos a partir de la configuración aplicada al compilador.

Volver

DataValidation: Es una representación de la regla de validación de datos.

Crea un compilador para una regla de validación de datos según la configuración de esta regla.

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

Volver

DataValidationBuilder: es un compilador basado en la configuración de esta regla.

Muestra true si la regla muestra una advertencia cuando la entrada falla la validación de datos, o false si rechaza la entrada por completo. El valor predeterminado para las nuevas reglas de validación de datos es true.

Volver

Boolean: true si la regla permite la entrada que falla en la validación de datos; false si no lo es

Obtiene el tipo de criterios de la regla como se define en la enumeración DataValidationCriteria. A fin de obtener los argumentos de los criterios, usa getCriteriaValues(). Si deseas usar estos valores para crear o modificar una regla de validación de datos, consulta 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.')
}

Volver

DataValidationCriteria: Es el tipo de criterios de validación de datos.

Obtiene un arreglo de argumentos para los criterios de la regla. Para obtener el tipo de criterios, usa getCriteriaType(). Si deseas usar estos valores para crear o modificar una regla de validación de datos, consulta 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.')
}

Volver

Object[]: Es un arreglo de argumentos apropiados para el tipo de criterios de la regla. La cantidad de argumentos y su tipo coinciden con el método require...() correspondiente de la clase DataValidationBuilder.

Obtiene el texto de ayuda de la regla o null si no se establece ningún texto de ayuda.

Volver

String: Es el texto de ayuda de la regla o null si no se establece ningún texto de ayuda.

Configura la regla de validación de datos para requerir que la entrada sea un valor booleano. Este valor se procesa como una casilla de verificación.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada sea el valor especificado o en blanco. Cuando la entrada coincide con el valor especificado, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada está en blanco, la celda se renderiza como una casilla de verificación desmarcada.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que se requiera que la entrada sea uno de los valores especificados. Cuando la entrada es checkedValue, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada es uncheckedValue, la celda se renderiza como una casilla de verificación desmarcada.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha posterior al valor determinado. Los campos de tiempo del objeto Date se ignoran; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha anterior al valor especificado. Los campos de tiempo del objeto Date se ignoran; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir una fecha que esté entre dos fechas especificadas o que se encuentre entre ellas. Los campos de tiempo de los objetos Date se ignoran; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha igual al valor especificado. Se ignoran los campos de tiempo del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha que no esté entre dos fechas especificadas y que no corresponda. Los campos de tiempo de los objetos Date se ignoran; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha igual o posterior al valor determinado. Se ignoran los campos de tiempo del objeto Date; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera una fecha igual o anterior al valor determinado. Los campos de tiempo del objeto Date se ignoran; solo se usan los campos de día, mes y año.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que se requiera que la fórmula dada se evalúe como true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número que se encuentre entre dos números especificados o que esté en uno de ellos.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número igual al valor especificado.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número mayor que el valor especificado.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número superior o igual al valor especificado.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número menor que el valor especificado.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número menor o igual que el valor especificado.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número que no esté entre dos números especificados y que no sea ninguno.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para que requiera un número que no sea igual al valor especificado.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada contenga el valor dado.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada no contenga el valor dado.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para exigir que la entrada sea igual al valor dado.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada tenga el formato de una dirección de correo electrónico.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada tenga la forma de una URL.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para exigir que la entrada sea igual a uno de los valores especificados.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos a fin de requerir que la entrada sea igual a uno de los valores especificados, con una opción para ocultar el menú desplegable.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para exigir que la entrada sea igual a un valor en el rango especificado.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos para requerir que la entrada sea igual a un valor en el rango dado, con una opción para ocultar el menú desplegable.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Establece si se muestra una advertencia cuando la entrada falla la validación de datos o si se rechaza por completo la entrada. El valor predeterminado para las nuevas reglas de validación de datos es true.

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Establece el texto de ayuda que aparece cuando el usuario se desplaza sobre la celda en la que se estableció la validación de datos.

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar

Configura la regla de validación de datos según los criterios definidos por los valores de DataValidationCriteria, que generalmente se toman del criteria y el arguments de una regla existente.

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

Parámetros

Volver

DataValidationBuilder: Este compilador, para encadenar